Python Try-Except Eğitimi: En İyi Uygulamalar ve Gerçek Dünya Örnekleri

Python kodu çalışma zamanında sorunlarla karşılaştığında, çoğu zaman bir istisna fırlatır. Ele alınmadan bırakılırsa, istisnalar programınızı çökertir. Ancak try-except bloklarıyla bunları yakalayabilir, zarifçe toparlanabilir ve uygulamanızı çalışır durumda tutabilirsiniz.

Bu eğitim istisnaların temelleri hakkında değil, bunu zaten Python'da İstisna ve Hata Yakalama rehberimizde ele aldık. Bunun yerine burada try-except uygulamada nasıl kullanılır, bloklarınızı nasıl yapılandırırsınız, yaygın hatalardan nasıl kaçınırsınız ve gerçek dünyada kodunuzu daha güvenilir kılan en iyi uygulamaları nasıl uygularsınız gibi konulara derinlemesine bakacağız.

Sonunda, try-except'in nasıl çalıştığını değil, aynı zamanda onu Pythonik şekilde nasıl kullanacağınızı; açık, sürdürülebilir ve üretime hazır hata yakalama kodu yazmayı da anlayacaksınız.

Python öğrenme yolculuğunuzda hâlâ ilerliyorsanız, tüm temel becerileri geliştirmenize yardımcı olacak Python Programlama Temelleri beceri rotasına göz atmanızı öneririm. 

Neden try-except'e Odaklanalım?

Python'da hata yakalama temelde beklenmeyenle başa çıkabilen programlar tasarlamakla ilgilidir. Hataları ele almak için birçok araç olsa da, try-except Python'un yaklaşımının bel kemiğidir.

Peki neden bu kadar önemli?

• Python'un felsefesini yansıtır. Python'da yaygın tarz EAFP; İzin İstemektense Affını İstemek Daha Kolaydır. Her şeyi en başta kontrol etmek (bu dosya var mı? bu giriş geçerli mi? sunucu erişilebilir mi?) yerine işlemi denersiniz. Başarısız olursa istisnayı yakalar ve ele alırsınız. Bu da daha kısa, daha temiz koda yol açar.
• Gerçek dünyada kodu çalışır tutar. Kullanıcı girdisi dağınık olacaktır, dosyalar kaybolacaktır, API'ler başarısız olacaktır ve ağlar kopacaktır. try-except ile kodunuz ilk sorunda çökmek yerine akıllıca tepki verir.
• Yeni başlayanlar ve profesyoneller için yeterince esnektir. Yeni başlayan biri, girişi tamsayıya çevirirken bir ValueError yakalamak için try-except kullanabilir. Bir üretim sistemi ise hataları günlüğe kaydetmek, başarısız işlemleri yeniden denemek veya hata ayıklamayı kolaylaştıran özel istisnalar yükseltmek için kullanabilir.

İşte bu yüzden bu makale try-except üzerine odaklanıyor. Bunu ustalaşmak, yalnızca kusursuz koşullarda çalışan betikler ile sağlam, sürdürülebilir ve üretime hazır yazılımlar yazmak arasındaki farktır.

Bir Try‑Except Bloğunun Anatomisi

En basit hâliyle:

try:
    risky_thing()
except SomeError:
    handle_it()

Python, try bloğu içinde bir hatayla karşılaştığında, programı çökertmek yerine eşleşen except bloğuna atlar.

Bu deseni else ve finally hükümleriyle de genişletebilirsiniz:

try:
    do_something()
except ValueError:
    print("Bad value!")
else:
    print("All good.")
finally:
    clean_up()

İşte temel bir çalışma örneği:

try:
    x = int(input("Enter a number: "))
except ValueError:
    print("That wasn’t a number.")
else:
    print("You entered", x)
finally:
    print("Done.")

except hatayı ele alır, else yalnızca işler yolunda giderse çalışır ve finally, Ctrl‑C'ye bassanız veya çıksanız bile her zaman çalışır.

Python'da kullanıcı girişi yakalamanın temellerini, basit istemlerden gelişmiş doğrulama ve hata yakalama tekniklerine kadar, Python Kullanıcı Girdisi: Yakalama, Doğrulama ve En İyi Uygulamalar eğitimimizle öğrenebilirsiniz. 

Birden Fazla İstisnayı Ele Alma

Bazen tek bir except yeterli olmaz. Farklı kod yolları farklı şekillerde başarısız olabilir ve çıplak bir except: ile her şeyi yakalamak pek yardımcı değildir; hataları gizleyebilir ve hata ayıklamayı bir baş ağrısına çevirebilir.

Diyelim ki bir şeyi tamsayıya dönüştürmeye ve sonra bölmeye çalışıyorsunuz. İşte yapmamanız gereken:

try:
    result = int(user_input) / 2
except:
    print("Something went wrong.")

Bu, değişken adlarında yazım hataları veya gerçek sorunlara işaret eden beklenmedik istisnalar gibi muhtemelen gizlemek istemediğiniz şeyler de dâhil olmak üzere her şeyi yakalar.

Bunun yerine, belirli olun:

try:
    result = int(user_input) / 2
except ValueError:
    print("That wasn't a number.")
except ZeroDivisionError:
    print("Division by zero?")

Aynı şekilde ele alınması gereken birden fazla istisna türünüz varsa, bunları şu şekilde gruplayabilirsiniz:

try:
    result = some_function()
except (TypeError, ValueError):
    print("Something was wrong with the data.")

Böylece, aynı bloğu tekrar tekrar kopyalamadan yine de nelerin ters gidebileceğini net biçimde belirtmiş olursunuz.

Bir de except Exception var, bu çıplak bir except'ten iyidir ama hâlâ fazla geniştir. Beklediğiniz belirli hataları hedeflemek daha iyidir.

else ve finally Bloklarını Kullanma

try bloğu içindeki kod başarıyla çalışır ve hiçbir istisna yükseltilmezse, Python else bloğunu yürütür. 

try:
    user_id = get_user_id()
except LookupError:
    print("User not found.")
else:
    print("Welcome, user", user_id)

Bu, istisna yakalama mantığınızı mutlu yolunuzdan ayırmanıza yardımcı olur ve okumayı kolaylaştırır.

Bir de finally var. Ne olduğuyla ilgilenmez; ne olursa olsun çalışır. İstisna mı? Yine çalışır. İstisna yok mu? Yine çalışır. Program Ctrl‑C ile mi sonlandırıldı? Yine çalışır. Temizlik işleri için harikadır:

try:
    f = open("data.txt")
    process(f)
except IOError:
    print("Couldn’t open file.")
finally:
    f.close()

Yalnız unutmayın, dosya hiç açılmadıysa f var olmamış olabilir, dikkatli olun. Dosyalarla çalışırken bunun yerine Python'un bağlam yöneticisini (with open(...) as f:) kullanabilirsiniz. Daha güvenlidir.

Python'da KeyError  istisnasını etkili bir şekilde ele almak için istisna yakalama ve hata önleme gibi temel teknikleri öğrenmek isterseniz, Python KeyError İstisnaları ve Nasıl Düzeltilir eğitimimizi öneririm. 

Python try-except En İyi Uygulamalar ve Yaygın Tuzaklar

Açık konuşalım: try‑except blokları yazmak biraz sanattır. Doğru yapıldığında programınızın çökmesini engeller. Kötü yapıldığında ise hataları o kadar derine gömer ki, uygulamanız çöküp kullanıcılar şikâyet edene kadar fark etmezsiniz.

İşte edinmeye değer bazı alışkanlıklar:

try bloklarını dar tutun. Yüzlerce satır kodu tek bir try içine sarmalayın demiyoruz. Bu yalnızca soruna neyin sebep olduğunu bilmeyi zorlaştırır. Bunun yerine, yalnızca başarısız olabilecek kodu sarmalayın:

# Good
try:
    value = int(data)
except ValueError:
    print("Couldn’t convert.")

# Bad
try:
    # Tons of unrelated logic
    value = int(data)
    do_more()
    something_else()
except ValueError:
    print("Huh?")

Eylemi yapmadan önce koşulları kontrol etmekten kaçının; hatayı yakalamak daha kolaysa doğrudan deneyin. Python bunu şöyle adlandırır: EAFP, Easier to Ask Forgiveness than Permission. Bir dosyanın var olup olmadığını kontrol edip sonra açıyorsanız, yarış durumu yaratıyorsunuz. Bunun yerine:

try:
    with open("file.txt") as f:
        content = f.read()
except FileNotFoundError:
    print("No file.")

Bu desen, dosyanın kontrol ile açma çağrısı arasında ortadan kaybolabileceği yaygın bir sorundan kaçınır. Sadece işi deneyin. Başarısız olursa, hatayı yakalayın.

Ayrıca, her şeyi yakalayıp hiçbir şey yapmayarak hataları susturmaktan kaçının. Bunu yapmayın:

try:
    something()
except:
    pass

Gerçekten ne yaptığınızı bilmiyorsanız, bu hataların saklanıp çoğalacağı yerdir. Mutlaka susturmanız gerekiyorsa, spesifik olun:

try:
    something()
except TimeoutError:
    # okay to ignore in this case
    pass

Ve hataları bir yere kaydedin. Tamamen yutmak, gelecekte neyin yanlış gittiğine dair hiçbir fikriniz olmayacağı anlamına gelir.

Yerleşik ve Özel İstisnalar

Python, pek çok yerleşik istisna ile birlikte gelir ve şaşırtıcı sayıda durumu kapsar. Muhtemelen bazılarına zaten rastladınız:

• ValueError: tür doğruyken değer geçersiz olduğunda, örneğin int("hello").
• TypeError: bir işlemi yanlış tür üzerinde kullanmaya çalıştığınızda, örneğin bir metin ile sayıyı toplamak gibi.
• ZeroDivisionError: tahmin ettiğiniz gibi, sıfıra bölme.
• FileNotFoundError: var olmayan bir dosyayı açmaya çalışmak.
• KeyError: sözlükte bir anahtar eksik olduğunda.

Bunlar kullanışlıdır ve çoğu betik veya uygulamada fazlasıyla yeterlidir. Ancak bazen daha açıklayıcı, projenizin dünyasında anlamlı olan bir şey yükseltmek isteyebilirsiniz; sadece Python'da değil.

Diyelim ki çevrimiçi siparişleri işleyen bir uygulama yazıyorsunuz ve kullanıcı stokta olmayan bir şeyi almaya çalıştığında bir hata yükseltmek istiyorsunuz. ValueError kullanabilirsiniz ama bu biraz genel kalır. Kodunuzu okuyan bir sonraki kişiye ne olduğunu söylemez.

İşte özel istisnaların parladığı yer.

class OutOfStockError(Exception):
    pass

def check_inventory(product_id):
    if not in_stock(product_id):
        raise OutOfStockError(f"Product {product_id} is out of stock.")

Özel istisna oluşturarak, bir anlam katmanı ekliyorsunuz. Ayrıca kendinize daha fazla kontrol sağlıyorsunuz; yalnızca bu belirli durumu yakalayabilirsiniz:

try:
    check_inventory("shirt-001")
except OutOfStockError:
    print("Sorry, that item is sold out.")

Küçük bir şeydir ama özellikle daha büyük projelerde kodunuzu anlamayı ve sürdürmeyi kolaylaştırır. Ve günlükleme ve izleme ile de iyi çalışır; özel istisna adlarını, belirsiz bir ValueError'dan çok daha kolay arayabilirsiniz.

Günlükleme, Yeniden Yükseltme ve İstisna Zincirleme

Hata ayıklarken şöyle bir an olur: bir yığın izi görür, ona bakar ve bir şeyin neden neden başarısız olduğunu anlamazsınız. İşte burada günlükleme devreye girer. Sadece hataları kaydetmekle ilgili değildir; gelecekteki size (veya ekibinize) neyin ters gittiğini bulmanız için ekmek kırıntıları vermekle ilgilidir.

Diyelim ki bir istisnayı yakalıyor ve yola devam etmeden önce kaydetmek istiyorsunuz:

import logging
logging.basicConfig(level=logging.ERROR)

try:
    do_something()
except ValueError as e:
    logging.error("Failed to do something: %s", e)
    raise

Sondaki raise önemlidir, günlüğe kaydettikten sonra aynı istisnayı yeniden fırlatır. Onsuz, hatayı yutmuş olursunuz. Bazen bu kabul edilebilir, ama genellikle değildir.

Bir de raise from numarası var. Bu, bir hatayı ele alırken başka birini yükseltmeniz gerektiğinde ve orijinali kaybetmek istemediğinizde kullanılır. Python bunları zincirlemenize izin verir:

try:
    connect_to_database()
except TimeoutError as e:
    raise ConnectionError("Database unavailable.") from e

Böylece yığın izi tüm hikâyeyi anlatır. Yeni ConnectionError'ı alırsınız ama buna neden olan TimeoutError'ı da görürsünüz. 

Orijinal hatayı bastırabilirsiniz (genellikle yapmamalısınız) şöyle:

raise ConnectionError("Just this error, nothing else.") from None

Ancak iyi bir nedeniniz olmadıkça, tam zinciri korumak neyin ters gittiğini ve nasıl büyüdüğünü herkesin anlamasına yardımcı olur.

Python'da günlüklemenin temellerini Python'da Günlükleme Eğitimi ile öğrenebilirsiniz. 

Gerçek Dünya Örnekleri ve Kullanım Alanları

İstisna yakalamayı soyut olarak konuşmak bir şeydir, ama gerçek koddaki hâliyle gördüğünüzde taşlar yerine oturur.

Örneğin kullanıcı girdisini ele alalım. Komut satırı aracı ya da form doğrulayıcı yazmış herkese sorun: kullanıcılar en tuhaf şeyleri girer. Siz sayı istersiniz; birisi “twelve” yazar. Ya da bir telefon numarası yapıştırır. Ya da sadece Enter'a basar. Olur böyle şeyler.

Uzun bir “ya şöyle olursa” kontrolleri listesi yazmak yerine şunu yapabilirsiniz:

while True:
    user_input = input("Enter a number: ")
    try:
        number = int(user_input)
        break
    except ValueError:
        print("Try again with a whole number.")

Bu kod, çöp bir giriş aldığında paniklemez. Kullanıcıya tekrar denemesini söyler ve işler yoluna girene kadar döngüye devam eder. Her köşe durumu için if deyimleri yığmaktan çok daha temiz.

Bir diğeri: var olmayabilecek bir dosyadan okuma.

try:
    with open("config.json") as f:
        settings = f.read()
except FileNotFoundError:
    print("Missing config file. Using defaults.")
    settings = "{}"

Dosyanın orada olup olmadığını kontrol etmeye gerek yok. Sadece açmayı deneyin ve başarısız olursa devam edin. Önceden kontrol etmeye kalksaydınız (os.path.exists()), biri kontrol ile açma arasında dosyayı silebilirdi. Bu bir yarış durumudur, hata ayıklamak isteyeceğiniz türden değil.

Ağ istekleri istisnalar için bir başka verimli alan. İnternetin her zaman uslu duracağına güvenemezsiniz. Sunucular çöker. Bağlantılar düşer. DNS başarısız olur. Dolayısıyla şöyle bir şey yapıyorsanız:

import requests

try:
    response = requests.get("https://example.com/data")
    response.raise_for_status()
except requests.exceptions.RequestException as e:
    print("Network problem:", e)

Şu RequestException taban sınıfı, requests'ın yükseltebileceği hemen her şeyi, zaman aşımlarından kötü yanıtlara kadar, uygun biçimde yakalar. Farklı şekilde ele almak istemiyorsanız on farklı except bloğu yazmanıza gerek yok.

Ve otomasyon betikleri ya da arka uç servisleri yazıyorsanız, kilit mantığı try‑except bloklarına sarmak, tek bir görevin başarısız olması ile tüm sistemin kararması arasındaki fark olabilir. Hataların kaydedilmesini, kurtarılabilir görevlerin yeniden denenmesini ve kurtarılamayanların, günlüklerinizi sonsuza dek kayan anlaşılmaz yığın izleriyle değil, temizce kapatılmasını istersiniz.

Python otomasyonu hakkında; temel kavramlar, kilit kütüphaneler, verilerle çalışma, yapay zekâ ile geliştirmeler ve en iyi uygulamalar dâhil bilgi edinmek için Python Otomasyonu: Kapsamlı Rehber eğitimimize göz atın. 

Try-except Python İleri Kullanımlar

Artık muhtemelen try‑except'in ne kadar esnek olabileceğini gördünüz. Ama esneklik iki ucu keskin kılıçtır. Farkında olmadan yararlıdan özensize kaymak kolaydır. İşleri kontrol altında tutmanın yolu şöyle.

Belirli istisnaları yakalayın. Neyin ters gidebileceğini biliyorsanız, adını verin:

try:
    result = int(data)
except ValueError:
    # Only catches invalid numbers, not everything else under the sun

Çıplak except:'ten kaçının. Çok özel bir şeyi ele almıyorsanız bunu yapmayın. KeyboardInterrupt, SystemExit ve muhtemelen susturmak istemeyeceğiniz diğer şeyleri de yakalar.

else ve finally'i kodu daha net yaptıklarında kullanın. Sırf varlar diye zorlamayın. Kodunuzun normal akışı bir try içinde gömülüyorsa, belki onu bir else'e taşıyın.

try bloklarınızı küçük tutun. Ne kadar çok şey eklerseniz hataya hangi satırın sebep olduğunu anlamak o kadar zor olur. Yalnızca başarısız olabilecek kısmı sarın. 

Özellikle üretimdeyken hataları gerektiğinde kaydedin. Çökmüyor olsanız bile neyin (ve ne zaman) başarısız olduğunu bilmek, daha sonra hata ayıklamayı çok daha kolaylaştırır.

Özel istisnalar şart değildir ama yardımcı olurlar. Uygulamaya özgü sorunlarınız varsa, kendi hatalarınızı tanımlayın. Günlükleri daha okunabilir, kodunuzu daha kendini açıklayan hâle getirebilirler.

Son bir şey: istisnaları, daha iyi bir yol olmadıkça, akış kontrolü için kullanmayın. “Bunu dene; başarısız olursa şunu yap” gibi mantık yazmak cazip gelebilir, ama bu sık sık olmasını beklediğiniz bir şeyse muhtemelen daha temiz bir yol vardır.

Sonuç

Bu makale boyunca açıkladığım gibi, istisna yakalama sadece çökmeleri önlemekle ilgili değildir. Sorun bekleyen, bunu abartmadan ele alan ve devam eden ya da mantıklı bir şekilde kapanan kod yazmakla ilgilidir. Bu, kullanıcının yardımcı bir mesaj alması ile uzun, okunamaz bir yığın iziyle terminale geri atılması arasındaki farktır.

İstisneler hakkında daha fazlasını, uygulamalı alıştırmalarla öğrenmek için OOP in Python kursumuzdaki Python'da İstisna Yakalama bölümünü şiddetle tavsiye ederim.