5.0 | Hata Yönetimi ve Debugging: Sorunları Fırsata Çevirmek

Yayınlanma Tarihi: 2026-05-13

Yazılım geliştirirken her şeyin planladığınız gibi gitmediği o an, gerçek öğrenmenin başladığı andır. Kodun çalışmaması bir başarısızlık değil, bir "iz sürme" serüvenidir.

1. Temel Bir Soru: "Neden Hataları Doğrudan Yapay Zekaya Sormuyoruz?"

Günümüzdeki en popüler soru şu: Ajan hatayı bulup çözebiliyorsa, ben neden nerede olduğunu aramakla vakit kaybediyorum? Bu sorunun cevabı, sizin neden "orkestra şefi" olduğunuzu kanıtlar. Ajan her ne kadar zeki olsa da, her şeyi göremez. Onu doğru yönlendirmek için sizin "gözlemci" rolünüzü üstlenmeniz gerekir.

2. Bağlam Yanılsaması: Ajanın Göremediği "Kör Noktalar"

Ajanlar, sadece sizin onlara gösterdiğiniz veya erişim izni verdiğiniz alanlarda çalışabilirler (Genellikle IDE içindeki dosyalar ve aktif terminal). Ancak modern yazılım ekosisteminde hataların çoğu ajanın bu "görüş alanı" dışında gerçekleşir. İşte ajanın ulaşamadığı ve sizin bulup ajana getirmeniz gereken o kritik veriler:

  • Web Tarayıcı Logları (Browser Console): Bir butonun neden çalışmadığı veya bir görselin neden yüklenmediği tarayıcının içindeki Console sekmesinde gizlidir. Ajan sizin tarayıcınızın içine girip o hatayı kendisi okuyamaz.
  • Bulut Fonksiyonları (Cloud Functions): Arka planda çalışan bir Firebase fonksiyonu hata verdiğinde, bu hata sizin bilgisayarınızda değil, Google sunucularındaki loglarda kalır. Siz o logu bulup ajana getirmezseniz, ajan koda bakıp "burada bir hata yok" diyerek sizi yanıltabilir.
  • Güvenlik Kuralları ve İzinler (Firebase Rules & Permissions): Kodunuz mükemmel olabilir ama Firebase veri tabanı kurallarınız veya uygulama izinleriniz (Kamera, Bluetooth) erişimi engelliyor olabilir. Ajan veri tabanı panelindeki o gizli ayarı göremez.
  • Donanım ve Fingerprint Hataları: Cihazın parmak izi okuyucusuyla veya özel donanım kimlikleriyle (Fingerprint) ilgili bir uyumsuzluğu ajan sadece koda bakarak anlayamaz. Cihazın canlı loglarını (Logcat/Console) sizin izlemeniz gerekir.

Ajan Nereye Erişebilir? Ajan; sadece IDE'de açık olan dosyalarınıza, aktif terminal penceresine ve projeye özel dahil ettiğiniz dökümanlara erişebilir. Ötesi için sizin rehberliğinize muhtaçtır.

3. Denetim Gücü: Son Karar Verici Sizsiniz

Ajan bir çözüm sunduğunda, bu çözüm "çalışıyor" olsa bile "doğru" olmayabilir. Kodbil’de kazandığınız Kod Okuryazarlığı burada devreye girer:

  • Mimari Uyumluluk: Ajan hatayı çözmek için projenize gereksiz, ağır bir kütüphane ekleyebilir veya performansınızı düşürecek bir yöntem önerebilir. "Bu çözüm işe yarıyor ama projemizi ağırlaştırıyor, daha temiz bir yol bulalım" diyebilmek sizin denetim gücünüzdür.
  • İş Mantığı (Business Logic): Ajan kodun çalışmasını sağlar ama sizin iş modelinizi %100 bilemez. Örneğin; bir indirim kuponu hatasını çözerken yanlışlıkla tüm sepeti ücretsiz yapabilir. Çözümü satır satır okuyup onaylamak sizin sorumluluğunuzdadır.

4. Bu Seride Neler Öğreneceğiz?

Ajanın göremediği yerlerden veriyi nasıl çekip onun önüne koyacağımızı adım adım inceleyeceğiz:

  • 5.1 | Web Debugging: Tarayıcı loglarını okumak ve DevTools kullanımı.
  • 5.2 | Mobil Debugging: Cihaz logları ve Flutter DevTools dünyası.
  • 5.3 | Test Ortamı: Hataları daha kullanıcıya ulaşmadan yakalayan sistemler.

Sözlük (Glossary)

  • Debugging (Hata Ayıklama): Yazılımdaki hataları bulma, analiz etme ve ortadan kaldırma süreci.
  • Blind Spot (Kör Nokta): Yapay zekanın erişim yetkisi olmadığı için göremediği veri kaynakları.
  • Cloud Logs: Sunucularda (Firebase vb.) tutulan ve sadece panel üzerinden erişilebilen işlem kayıtları.
  • Verification (Doğrulama): Ajanın sunduğu çözümü mimari, güvenlik ve mantık süzgecinden geçirme işlemi.

Sonraki Adım: 5.1 | Web Debugging: Tarayıcıda İz Sürmek.