Debugging yang sistematis
Debugging bukan menebak-nebak sampai berhasil. Ini sebuah metode: reproduksi bug-nya, baca apa yang dikatakan program, buat dugaan, uji, persempit. Satu bug nyata dilacak dari awal sampai akhir, ditambah print dan logging, debugger di empat bahasa, dan git bisect.
Debugging adalah “the process of finding the root cause, workarounds, and possible fixes for bugs”: proses menemukan akar masalah, jalan pintas, dan kemungkinan perbaikan untuk bug. Kata yang penting adalah akar masalah. Membuat gejalanya hilang itu mudah: tambah if, tangkap exception-nya, restart server. Mencari tahu kenapa itu terjadi adalah pekerjaan sebenarnya, dan hanya itu yang mencegah bug kembali dalam bentuk lain.
Kabar baiknya, debugging adalah keterampilan dengan metode, bukan bakat. Bagian ini menjalankan metode itu pada satu bug nyata, lalu membahas alat-alatnya: print dan logging, debugger, dan git bisect.
Metodenya
Hampir setiap sesi debugging yang baik mengikuti putaran yang sama:
- Reproduksi bug-nya, secara konsisten, idealnya dengan input terkecil yang masih menunjukkannya.
- Baca apa yang sudah dikatakan program: error, stack trace, log.
- Duga penyebab (hipotesis) yang bisa menjelaskan apa yang terlihat.
- Uji dugaan itu dengan eksperimen: cetak sebuah nilai, pasang breakpoint, ubah satu hal.
- Persempit. Kalau dugaannya salah, setidaknya satu kemungkinan sudah tersingkir. Ulangi.
- Perbaiki penyebabnya, lalu tambah tes supaya tetap beres (bagian 14).
Ini metode ilmiah yang diterapkan pada kode. Kesalahan paling umum adalah langsung melompat dari “ada yang salah” ke “ubah-ubah sampai jalan”. Kadang gejalanya memang hilang, tapi Anda tidak tahu kenapa, jadi Anda juga tidak tahu apa lagi yang ikut rusak.
Satu bug nyata, dari awal sampai akhir
Laporan bulanan dari bagian 9 mendapat keluhan: “Pendapatan Januari kok kecil.” Ini file dan kodenya:
date,product,qty,price,status
2026-01-03,book,2,85000,paid
2026-1-15,pen,10,4000,paid
2026-01-20,mug,3,35000,paid
2026-1-28,book,1,85000,paid
def month_of(row):
return row["date"][:7]
def revenue_in_month(rows, month):
return sum(int(r["qty"]) * int(r["price"]) for r in rows
if month_of(r) == month and r["status"] == "paid")
Reproduksi. Jalankan:
2026-01 revenue: 275000
Hitung manual: 170.000 + 40.000 + 105.000 + 85.000 = 400.000. Jadi bug-nya nyata, dan bisa dimunculkan setiap saat. Itu saja sudah setengah perjuangan. Bug yang bisa direproduksi kapan saja hampir selalu bisa diperbaiki.
Baca. Tidak ada error, tidak ada stack trace. Programnya salah dengan penuh percaya diri. Ini jenis kegagalan diam-diam dari bagian 13, jadi kita harus membuatnya bicara.
Duga. Yang hilang 125.000, persis baris pen (40.000) ditambah baris book kedua (85.000). Apa kesamaan dua baris itu? Hipotesis: baris-baris itu tidak terhitung sebagai Januari.
Uji. Alih-alih memelototi kode, tanyakan ke program bulan apa saja yang dilihatnya:
from collections import Counter
print(Counter(month_of(r) for r in read_orders("orders.csv")))
Counter({'2026-01': 2, '2026-1-': 2})
Ketemu. Dua tanggal ditulis 2026-1-15 dan 2026-1-28, tanpa nol di depan, dan mengambil tujuh karakter pertama menghasilkan '2026-1-', yang bukan '2026-01'. Hipotesisnya benar, dan sekarang kita tahu persis kenapa.
Perbaiki penyebabnya. Akar masalahnya bukan “ada baris yang salah”. Masalahnya, kode memperlakukan tanggal sebagai string dan mengasumsikan format yang tetap. Urai sebagai tanggal:
from datetime import datetime
def month_of(row):
d = datetime.strptime(row["date"], "%Y-%m-%d")
return f"{d.year:04d}-{d.month:02d}"
2026-01 revenue: 400000
Lalu regression test supaya tetap beres: month_of({"date": "2026-1-15"}) == "2026-01".
Bug yang sama ada di bahasa apa pun yang memotong string. Di PHP, substr("2026-1-15", 0, 7) menghasilkan 2026-1-, sedangkan date("Y-m", strtotime("2026-1-15")) menghasilkan 2026-01.
Print dan logging
Counter di atas adalah print yang punya tujuan, dan print adalah alat debugging yang sah. Dua kebiasaan membuatnya jauh lebih berguna:
- Cetak pertanyaannya, bukan sekadar nilainya.
print(month_of(r))menampilkan sederet tanggal.Counter(...)menjawab “bulan apa saja yang ada?” dalam satu baris. - Cetak dengan label dan
repr.print(f"{qty=!r}")menampilkanqty='3 ', lengkap dengan tanda kutip dan spasi di belakang yang akan tersembunyi olehprint(qty)biasa.
Untuk apa pun yang berjalan berulang kali atau di production, pakai logging, bukan print. Logging HOWTO di dokumentasi Python: “Logging is a means of tracking events that happen when some software runs.” Panduannya sendiri: pakai print() untuk “Display console output for ordinary usage of a command line script or program”, dan logger untuk “Report events that occur during normal operation of a program (e.g. for status monitoring or fault investigation)”: print untuk output biasa, logger untuk mencatat kejadian selama program berjalan, termasuk untuk menyelidiki masalah.
import logging
logging.basicConfig(level=logging.INFO, format="%(levelname)s %(name)s: %(message)s")
log = logging.getLogger("import")
log.info("start file=%s rows=%d", "orders.csv", 4)
log.warning("skip line=%d reason=%s value=%r", 3, "bad date", "2026-13-01")
log.debug("this line is hidden at INFO level")
INFO import: start file=orders.csv rows=4
WARNING import: skip line=3 reason=bad date value='2026-13-01'
Level membuat Anda bisa menyimpan baris debug yang detail di kode dan menyalakannya hanya saat perlu. Perhatikan juga bahwa baris log membawa konteks apa/di mana/nilai yang sama dengan pesan error di bagian 13. Saat laporan bug datang bulan depan, log yang baik sering kali satu-satunya bukti yang Anda punya.
Debugger: hentikan program dan lihat-lihat
Debugger memungkinkan Anda menghentikan program yang sedang berjalan di sebuah baris, melihat setiap variabel, dan melangkah maju baris demi baris. pdb di Python “supports setting (conditional) breakpoints and single stepping at the source line level, inspection of stack frames, source code listing, and evaluation of arbitrary Python code in the context of any stack frame”: mendukung breakpoint, menjalankan per baris, melihat stack frame, menampilkan kode, dan mengevaluasi kode Python di frame mana pun.
Ini bug Januari yang sama, ditemukan dengan pdb alih-alih print. Pasang breakpoint di month_of, lanjutkan sampai berhenti di sana, lalu cetak nilainya:
(Pdb) b report.py:9
(Pdb) c
-> return row["date"][:7]
(Pdb) p row["date"]
'2026-01-03'
(Pdb) p row["date"][:7]
'2026-01'
(Pdb) c
-> return row["date"][:7]
(Pdb) p row["date"]
'2026-1-15'
(Pdb) p row["date"][:7]
'2026-1-'
Berhenti kedua langsung menunjukkan masalahnya. Anda juga bisa menaruh breakpoint() di kode untuk berhenti tepat di sana, seperti disebut di bagian 12.
Setiap bahasa punya alat yang sama:
- PHP: “Xdebug’s step debugger allows you to interactively walk through your code to debug control flow and examine data structures.” Xdebug bisa disambungkan ke VS Code, PhpStorm, dan editor lain.
- Go: “Delve is a debugger for the Go programming language.” Ekstensi Go di VS Code memakainya di balik layar.
- JavaScript: DevTools di browser, atau
node --inspectuntuk Node. Pernyataandebugger“invokes any available debugging functionality, such as setting a breakpoint”, memanggil fitur debugging yang tersedia, misalnya breakpoint.
Debugging dengan print cepat saat Anda sudah punya dugaan yang bagus. Debugger lebih baik saat Anda belum tahu harus melihat ke mana, karena Anda bisa menjelajah tanpa mengedit dan menjalankan ulang setiap kali.
Saat bug datang dari sebuah perubahan: git bisect
Kadang Anda tahu sesuatu masih jalan minggu lalu dan sekarang tidak, tapi sudah ada puluhan commit sejak itu. git bisect akan “Use binary search to find the commit that introduced a bug”. Ini binary search dari bagian 10, diterapkan pada riwayat.
Anda beri tahu satu commit yang rusak dan satu yang masih baik. Kalau Anda juga memberinya skrip, sisanya dikerjakan sendiri: skrip itu “should exit with code 0 if the current source code is good/old, and exit with a code between 1 and 127 (inclusive), except 125, if the current source code is bad/new.” Keluar dengan kode 0 kalau baik, dan 1 sampai 127 (kecuali 125) kalau rusak.
Di repo contoh kecil dengan 12 commit, diskon 10 barang dari bagian 14 berhenti bekerja di suatu titik. Pemeriksanya:
import sys
sys.path.insert(0, ".")
from pricing import final_price
sys.exit(0 if final_price(100, 10) == 950 else 1)
$ git bisect start HEAD d72e099
$ git bisect run python3 check_discount.py
Bisecting: 5 revisions left to test after this (roughly 3 steps)
[91985178...] Tidy pricing comments (6)
Bisecting: 2 revisions left to test after this (roughly 1 step)
[e51a9244...] Tidy pricing comments (3)
Bisecting: 0 revisions left to test after this (roughly 1 step)
[52eac298...] Simplify discount condition
Bisecting: 0 revisions left to test after this (roughly 0 steps)
[f6428db6...] Tidy pricing comments (4)
52eac29864676b636367ed3b96f25c590fa71a29 is the first bad commit
Simplify discount condition
Empat kali pemeriksaan untuk mencari di antara 12 commit. Dengan 1.000 commit, kira-kira 10 kali. Akhiri dengan git bisect reset untuk kembali ke posisi semula. Commit yang kecil dan fokus membuat ini makin berguna, yang akan dibahas lagi di bagian 16.
Kebiasaan yang menghemat berjam-jam
- Periksa asumsi Anda, satu per satu. Apakah itu file yang Anda kira? Apakah kode yang Anda edit memang kode yang sedang berjalan? Apakah cache sudah dibersihkan? Banyak sekali bug yang “mustahil” ternyata build yang basi atau environment yang salah.
- Ubah satu hal setiap kali. Ubah tiga hal lalu tiba-tiba jalan, dan Anda tidak tahu mana yang berpengaruh, atau apakah dua lainnya merusak sesuatu.
- Bandingkan yang jalan dan yang rusak. Jalan untuk satu pelanggan, tidak untuk yang lain? Jalan di lokal, tidak di server? Daftar perbedaannya. Bug-nya ada di salah satunya.
- Perkecil inputnya. Kalau file 40.000 baris gagal, belah dua dan lihat setengah mana yang masih gagal. Terus sampai tersisa satu baris.
- Baca seluruh pesan error, termasuk bagian di bawah baris pertama. Stack trace menunjukkan jalur yang ditempuh program; baris paling berguna sering kali kode Anda sendiri, tepat di atas kode library.
- Jelaskan ke orang lain, atau ke bebek karet (bagian 9). Mengucapkan “lalu nilai ini selalu positif” sering menjadi saat Anda sadar ternyata tidak.
- Istirahat. Kalau sudah buntu satu jam, jalan sebentar sering lebih membantu daripada satu jam lagi memelototi layar.
Sebagian bug melawan balik. Heisenbug adalah “a software bug that seems to disappear or alter its behavior when one attempts to study it”, bug yang seolah hilang atau berubah saat diselidiki, sering karena menambah print mengubah timing. Biasanya terkait konkurensi atau timing, yang dibahas di bagian 21.
Kenapa ini penting sehari-hari
- Sebagian besar waktu untuk sebuah bug habis untuk menemukannya, bukan memperbaikinya. Metode membuat bagian menemukan jadi lebih singkat dan tidak terlalu bikin stres.
- Akar masalah, bukan gejala. Membungkus bug Januari dengan
tryatau menambah kasus khusus untuk “2026-1-” hanya akan menyembunyikannya sampai Februari. - Log yang baik adalah hadiah untuk diri Anda di masa depan. Bug di production sering tidak bisa direproduksi di lokal; log adalah buktinya.
- AI membantu debugging, tapi butuh bukti. Menempelkan error yang sebenarnya, inputnya, dan apa saja yang sudah Anda singkirkan menghasilkan bantuan yang jauh lebih baik daripada “kok nggak jalan”. Dan perbaikan yang disarankan tetap perlu dicek dengan cara yang sama: apakah itu menjelaskan penyebabnya?
Coba sendiri
- Reproduksi sendiri bug Januari, lalu temukan sekali dengan
printdan sekali denganbreakpoint(). - Tambahkan baris bertanggal
2026-01-5ke CSV. Apakahmonth_ofyang sudah diperbaiki menanganinya? Tambahkan tes, apa pun hasilnya. - Buat repo kecil, rusak sesuatu di satu commit di antara sepuluh, lalu temukan dengan
git bisect run. - Lain kali Anda buntu, tulis hipotesis Anda sebelum mengubah kode apa pun. Apakah benar?
Ringkasan
- Debugging berarti menemukan akar masalah, bukan menyembunyikan gejala.
- Metodenya: reproduksi, baca, duga, uji, persempit, perbaiki lalu tambah tes.
- Print dengan tujuan dan dengan
repr; pakai logging dengan level dan konteks untuk apa pun yang berjalan berulang. - Debugger (pdb, Xdebug, Delve, DevTools) membuat Anda bisa berhenti dan memeriksa tanpa mengedit kode.
git bisectmelakukan binary search di riwayat untuk menemukan commit yang memunculkan bug.- Periksa asumsi, ubah satu hal setiap kali, bandingkan yang jalan dan yang rusak, perkecil inputnya.
Referensi
- pdb — The Python Debugger dan Logging HOWTO, dokumentasi Python.
- git-bisect, dokumentasi Git.
- Step Debugging, dokumentasi Xdebug; Delve; debugger, MDN Web Docs.
- Debugging dan Heisenbug, Wikipedia.