İçeriğe geç

Bug raporu örnekleri: iyi ve kötü, yan yana

Dört gerçekçi bug raporu örneği; her biri zayıf bir rapor ve güçlü bir yeniden yazımla, raporu işe yarar kılan şeylere dair notlarla.

İyi bir bug raporu örneği her seferinde aynı parçalardan oluşur: belirli bir başlık, ortam, bilinen bir başlangıç noktasından numaralı yeniden üretme adımları, hata metniyle birlikte beklenen ve gerçekleşen sonuç, ne sıklıkla olduğu ve kanıt. Aşağıda dört gerçekçi bug var ve her biri iki kez yazılmış: önce bug'ların çoğu zaman raporlandığı biçimde, sonra bir geliştiricinin tek bir soru sormadan üzerinde çalışabileceği bir yeniden yazımla.

Örnekler en yaygın bug türlerini kapsıyor: sessizce başarısız olan bir akış, tek bir cihazdaki yerleşim sorunu, yanlış veri ve ara sıra ortaya çıkan bir hata. Formatın boş bir sürümünü istiyorsan bug raporu şablonumuzu kopyala. Her alanın arkasındaki mantık için bug raporu nasıl yazılır rehberine bak.

1. Örnek: Sessizce başarısız olan bir akış

Bir kullanıcı şifresini sıfırlıyor ama e-posta hiç gelmiyor.

Zayıf sürüm

Başlık: Şifre sıfırlama bozuk

Şifre sıfırlama çalışmıyor. Birkaç kez denedim. Lütfen ACİL düzeltin.

Bu rapor geliştiriciye neredeyse hiçbir şey vermiyor. Hangi hesap? Hangi ortam? Form bir hata mı gösterdi, yoksa başarılı olduğunu mu söyledi? "Birkaç kez denedim" bir şeye işaret ediyor, ama neye olduğunu söylemiyor. Etkisini belirtmeyen bir "ACİL" de kimsenin önceliklendirmesine yardım etmiyor.

Güçlü sürüm

Başlık: Google ile giriş yapılarak oluşturulan hesaplara şifre sıfırlama e-postası gönderilmiyor

Ortam
- URL: https://app.example.com/forgot-password
- Chrome 154, macOS 26
- Hesap: [email protected] ("Google ile devam et" ile oluşturuldu)
- Zaman: 2026-11-10 09:12 UTC

Yeniden üretme adımları
1. Oturum kapalıyken /forgot-password sayfasına git.
2. [email protected] adresini gir ve "Sıfırlama bağlantısı gönder"e tıkla.

Beklenen
Birkaç dakika içinde bir sıfırlama e-postası gelir.

Gerçekleşen
Sayfada "Gelen kutunu kontrol et" yazıyor. E-posta gelmiyor (30 dakika
bekledim, spam klasörüne de baktım). Ağ: POST /api/auth/reset, şu body ile
200 döndürdü: {"sent": false, "reason": "no_password_identity"}.

Sıklık
Google ile oluşturulan hesaplarda her zaman (3/3). E-posta/şifre ile
oluşturulan bir hesapta çalışıyor ([email protected]).

Önem derecesi
Büyük: Google ile kaydolan kullanıcılar şifre belirleyemiyor.

Neden işe yarıyor

Raporu yazan kişi iki hesap türünü karşılaştırmış ve kalıbı bulmuş: yalnızca Google ile giriş yapılarak oluşturulan hesaplar etkileniyor. Bu tek karşılaştırma, nedeni "e-posta bozuk"tan koddaki belirli bir dala daraltıyor. Ayrıca Network panelini açıp yanıt body'sini kopyalamış; bu da sayfa başarılı olduğunu söylerken sunucunun hiçbir şey göndermediğini bildiğini gösteriyor. Bu uyuşmazlık, not etmeye değer ikinci bir bug. Tam zaman bilgisi de ekibin e-posta sağlayıcısının loglarına bakabilmesini sağlıyor. Daha önce hiç ağ isteklerine bakmadıysan Chrome'da ağ trafiğini yakalama rehberimiz nasıl yapılacağını gösteriyor.

2. Örnek: Tek bir cihazda yerleşim bug'ı

Küçük bir telefon ekranında bir banner, kullanıcıların basması gereken düğmeyi kapatıyor.

Zayıf sürüm

Başlık: Mobilde kaydet'e tıklanamıyor

Kaydet düğmesi telefonumda çalışmıyor.

"Çalışmıyor", düğmenin hiçbir şey yapmadığı, bir hata gösterdiği ya da ona ulaşılamadığı anlamına gelebilir. "Telefonum" binlerce cihaz ve tarayıcıdan herhangi biri olabilir. Büyük bir telefonda test eden geliştirici büyük ihtimalle hiçbir sorun görmez ve kaydı kapatır.

Güçlü sürüm

Başlık: Küçük ekranlarda profil sayfasında çerez banner'ı Kaydet düğmesini kapatıyor

Ortam
- URL: https://app.example.com/settings/profile
- iPhone SE (3. nesil) üzerinde Safari, iOS 26, dikey
- Görüntü alanı yaklaşık 375 x 667
- iPhone 15 Pro'da ve masaüstünde yeniden üretilemiyor

Yeniden üretme adımları
1. URL'yi gizli bir sekmede aç (çerez banner'ı görünsün diye).
2. [email protected] olarak giriş yap.
3. Profil formunun en altına kaydır.

Beklenen
Kaydet düğmesi çerez banner'ının üstünde görünür ve dokunulabilir.

Gerçekleşen
Çerez banner'ı (sabit, yaklaşık 180 px yüksekliğinde) Kaydet düğmesini kapatıyor.
Düğmenin olması gereken yere dokunmak banner'ın "Ayarlar" bağlantısını açıyor.
Banner kapatılınca Kaydet'e ulaşılabiliyor.

Geçici çözüm
Önce çerez banner'ını kabul et ya da kapat.

Ekler
- Ekran görüntüsü: profile-save-hidden-iphone-se.png (banner kırmızıyla çevrili)

Neden işe yarıyor

Yerleşim bug'ları ekran boyutuna bağlıdır; bu yüzden tam cihaz, yön ve görüntü alanı en önemli bilgilerdir. Raporu yazan kişi başka cihazlarda da denemiş ve sorunun nerede olmadığını not etmiş; bu da geliştiriciye küçük ekran stillerine bakmasını söylüyor. Gizli sekme adımı banner'ın görünmesini garanti ediyor, böylece geliştirici aynı ekranı görüyor. Geçici çözüm, destek ekibine kullanıcılara bugün ne söyleyeceğini anlatıyor ve aciliyeti, ekibin kendisinin değerlendirebileceği bir biçimde düşürüyor.

3. Örnek: Yanlış veri

Panodaki toplam, dışa aktarılan rakamlarla uyuşmuyor.

Zayıf sürüm

Başlık: Rakamlar yanlış

Panodaki gelir yanlış. Dışa aktarımda farklı bir şey görünüyor.
Hangisi doğru bilmiyorum ama biri bozuk.

Raporu yazan kişi gerçek bir şey fark etmiş, ama "rakamlar yanlış" geliştiriciyi hangi rakamlar, hangi dönem ve ne kadar fark olduğunu aramaya zorluyor. Veri bug'ları tam değerler ister, çünkü farkın büyüklüğü çoğu zaman ipucunun kendisidir.

Güçlü sürüm

Başlık: Ekim ayı için panodaki gelir CSV dışa aktarımından 1.240 $ düşük

Ortam
- URL: https://app.example.com/reports/revenue?period=2026-10
- Çalışma alanı: Acme Demo (ID 4821), saat dilimi America/Los_Angeles
- Chrome 154, Windows 11

Yeniden üretme adımları
1. Raporlar'ı, ardından Gelir'i aç.
2. Ekim 2026'yı seç.
3. Karttaki toplamı not et.
4. "CSV olarak dışa aktar"a tıkla ve Tutar sütununu topla.

Beklenen
Panodaki toplam ile CSV toplamı eşleşir.

Gerçekleşen
Pano: 48.310,00 $. CSV toplamı: 49.550,00 $. Fark: 1.240,00 $.
Fark, 31 Ekim'de Los Angeles saatiyle 17:00'den sonra verilen
üç siparişe eşit (ID'ler 99812, 99815, 99820).

Sıklık
Ekim için her zaman. Eylül toplamları eşleşiyor.

Notlar (tahmin)
Pano tarihe göre UTC ile, dışa aktarım ise çalışma alanının saat
dilimiyle gruplanıyor gibi görünüyor.

Neden işe yarıyor

Rapor iki rakamı, farkı ve farkı oluşturan siparişleri veriyor. O son adım raporu yazana birkaç dakikaya mal olmuş, ama geliştiriciye çok daha fazlasını kazandırıyor. Saat dilimiyle ilgili tahmin açıkça tahmin olarak etiketlenmiş ve gözlemlerden ayrı tutulmuş. Eylül'ün eşleştiğini belirtmek de bug'ın raporun tamamına değil, belirli bir veriye bağlı olduğunu gösteriyor.

4. Örnek: Ara sıra ortaya çıkan bir hata

Yüklemeler bazen başarısız oluyor ve kimse nedenini söyleyemiyor.

Zayıf sürüm

Başlık: Yükleme bazen başarısız oluyor

Bazen yüklemeler bir hatayla başarısız oluyor. Rastgele oluyor.

"Rastgele" genellikle "henüz kimsenin bulmadığı bir nedenle" demektir. Hata metni, dosya bilgileri ya da bir sayı olmadan araştırılacak hiçbir şey yok.

Güçlü sürüm

Başlık: 10 MB'tan büyük dosyaları yüklemek "Yükleme başarısız (413)" hatasıyla sonuçlanıyor

Ortam
- URL: https://app.example.com/projects/218/files
- Chrome 154 ve Firefox 158, Windows 11, ofis ağı

Yeniden üretme adımları
1. Bir proje aç, ardından Dosyalar sekmesini aç.
2. "Yükle"ye tıkla ve 10 MB'tan büyük bir PDF seç
   (denenenler: 10,4 MB, 12 MB, 25 MB).

Beklenen
Dosya yüklenir ve listede görünür.

Gerçekleşen
İlerleme çubuğu yaklaşık yüzde 90'a ulaşıyor, sonra "Yükleme başarısız (413)".
Ağ: POST /api/files, 413 Request Entity Too Large döndürdü;
yanıt body'si JSON değil, bir HTML hata sayfası.
Konsol: Uncaught (in promise) SyntaxError: Unexpected token '<'

Sıklık
10 MB'tan büyük dosyalarda her zaman (6/6). 9 MB'tan küçüklerde hiçbir zaman (0/8).

Ekler
- Başarısız bir yüklemenin ekran kaydı (40 saniye)
- Tek bir denemenin temizlenmiş HAR dosyası

Neden işe yarıyor

"Rastgele" bug'ın dosya boyutuna bağlı olduğu ortaya çıktı ve raporu yazan kişi bunu eşiğin iki tarafındaki sayılarla kanıtladı. 413 durum kodu ve HTML yanıtı, uygulamanın önünde bir yerde bir boyut sınırına işaret ediyor; konsol hatası da kullanıcının neden genel bir mesaj gördüğünü açıklıyor: uygulama bir HTML sayfasını JSON olarak okumaya çalışmış. HAR dosyası temizlenmiş, çünkü HAR dosyaları çerez ve token taşır; HAR temizleyici bunları tarayıcında siler.

Zayıf bir raporu güçlü bir rapora dönüştürmek

Bir destek ya da QA ekibi için bug'ları sınıflandırıyorsan yukarıdaki zayıf sürümlere benzeyen çok rapor alırsın. Beş sorunun yanıtını alabildiğin sürece onları yeniden yazmak, geri göndermekten daha hızlıdır:

  1. Tam olarak ne gördün? Hatanın tarifini değil, hata metnini ya da bir ekran görüntüsünü iste.
  2. Neredeydin? URL ya da ekranın adı ve hesap.
  3. Hemen öncesinde ne yaptın? Son iki üç işlem, yeniden üretmeye başlamak için genellikle yeterlidir.
  4. Her seferinde oluyor mu? Olmuyorsa yaklaşık ne sıklıkla ve olma ihtimalini artıran bir şey var mı?
  5. Ne yapmaya çalışıyordun? Bu sana beklenen sonucu ve gerçek etkiyi söyler.

Beşini de tek mesajda sor. Raporu yazanlar, özellikle de müşteriler, tek bir soru turunu memnuniyetle yanıtlar; üç tur olunca vazgeçerler. Yanıtları aldığında bug'ı kendin yeniden üretmeyi dene ve yukarıdaki örneklerdeki karşılaştırmalar gibi öğrendiklerini ekle. Kendi kanıtın eklenmiş, yeniden üretilmiş bir bug, iletilmiş bir e-postadan çok daha hızlı ilerler.

İyi örneklerin ortak noktaları

  • Yalnızca özelliği değil, belirtiyi ve koşulu anlatan başlıklar.
  • Bilinen bir başlangıç noktası ve kullanılan verinin tam hâli.
  • Tam sayılar ve hata metni; asla "yanlış" ya da "bir hata" değil.
  • Bir karşılaştırma: sorunun olmadığı başka bir hesap, cihaz, ay ya da dosya boyutu.
  • Gizli bilgileri silinmiş, eklenmiş kanıt.
  • Tahmin olarak etiketlenmiş tahminler.

Kanıtı daha hızlı toplamak

Yukarıdaki güçlü sürümlerin çoğu konsola ve Network paneline ihtiyaç duydu. Ücretsiz bir Chrome eklentisi olan Midge, sen ekranını kaydederken ya da ekran görüntüsü alırken ikisini de yakalar. Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir. Başlığı, adımları ve beklenen sonucu yine sen yazarsın; teknik ayrıntılar ekli gelir.

İlgili rehberler

Sık sorulan sorular

İyi bir bug raporu örneği nasıl görünür?

Belirli bir başlığı, ortam bilgisini, bilinen bir başlangıç noktasından numaralı adımları, hata metniyle birlikte beklenen ve gerçekleşen sonucu, ne sıklıkla olduğunu ve ekran görüntüsü, konsol hatası ya da başarısız istek gibi kanıtları vardır.

Bug raporlarındaki en yaygın hata nedir?

Eksik ya da belirsiz yeniden üretme adımları. Bunlar olmadan geliştirici bug'ın nasıl olduğunu tahmin etmek zorunda kalır; bu da çoğu zaman "yeniden üretilemiyor" diye kapatılan bir kayıtla sonuçlanır.

Bug raporuna ekran görüntüsü eklenmeli mi?

Evet, sorun gözle görülüyorsa. Hata metnini de ekle, çünkü metin aranabilir ve kopyalanabilir; bug birkaç adım ya da zamanlama içeriyorsa kısa bir kayıt da ekle.

Bu formatın boş bir sürümünü nereden bulabilirim?

Midge dokümanlarındaki kopyala-yapıştır bug raporu şablonunu kullan. Bu sayfadaki iyi örneklerle aynı alanlara sahip.