ChromeDriver Sürüm Uyuşmazlığı Hatası Nasıl Çözülür?

Selenium işiniz cuma günü sorunsuz çalıştı. Pazartesi sabahı ise ilk satırdaki webdriver.Chrome() çağrısında SessionNotCreatedException ile duruyor ve ekrana iki satır yazıyor: This version of ChromeDriver only supports Chrome version 152 ve Current browser version is 154.0.8037.92. Koda kimse dokunmadı. Chrome hafta sonu kendini güncelledi, diskteki chromedriver dosyası olduğu yerde kaldı.

Bu yazıda önce mesajı okuyoruz, ChromeDriver'ın uyguladığı kuralı kaynak kodundan gösteriyor ve hatanın neden artık birkaç haftada bir geri geldiğini anlatıyoruz. Ardından çözümler geliyor: Selenium Manager, PATH üzerinde kalmış eski sürücü, Chrome for Testing, Docker ve CI, Edge'deki aynı hata ve eski sürücüyü adıyla gösteren, denenmiş bir Python betiği.

"This version of ChromeDriver only supports Chrome version" ne anlama gelir?#

ChromeDriver, Selenium ile Chrome arasında duran küçük bir programdır: Selenium ona "şu adresi aç" gibi standart WebDriver komutları gönderir, ChromeDriver de bunları Chrome'un anladığı komutlara çevirir. Her ChromeDriver derlemesi bir Chrome sürümüyle aynı kaynak ağacından çıkar ve onun sürüm numarasını taşır.

Oturum (session), kodunuzun quit() çağrısına kadar yönettiği tek bir tarayıcıdır; "session not created" bu noktaya hiç gelinmediğini söyler. Denememizde ChromeDriver 152 ve Chrome 154 test derlemesiyle Selenium 4.50'nin yazdığı mesaj şuydu (yol kısaltıldı, yığın izi kesildi):

selenium.common.exceptions.SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version 152
Current browser version is 154.0.8037.92 with binary path ...\154.0.8037.92\chrome-win64\chrome.exe; For documentation on this error, please visit: https://www.selenium.dev/documentation/webdriver/troubleshooting/errors#sessionnotcreatedexception

Mesajın üç parçası var:

• only supports Chrome version 152: Selenium'un başlattığı sürücünün ana sürümü.
• Current browser version is 154.0.8037.92: bu sürücünün açtığı Chrome'un tam sürümü.
• with binary path: diskteki Chrome dosyası. Aynı makinede Chrome, Chrome Beta ve bir test derlemesi varsa hangisinin seçildiğini buradan anlarsınız.

Metni Python paketi değil ChromeDriver'ın kendisi üretir; bu yüzden Java, C# ve JavaScript de kendi istisnalarının içinde aynı iki satırı gösterir. Altındaki yığın izi (stack trace) sürücüye aittir ve bu hatada işe yarar bir şey söylemez.

ChromeDriver hangi Chrome sürümlerini kabul eder?#

Kontrol, ChromeDriver'ın başlatıcı kaynak kodundaki CheckVersion adlı kısa bir fonksiyondur ve iki sürümün yalnızca ilk numarasını karşılaştırır:

1. Ana sürüm aynıysa oturum başlar.
2. Chrome sürücüden tam bir ana sürüm yeniyse oturum yine başlar, sürücü log dosyasına bir uyarı yazar. Kaynaktaki yorum gerekçeyi söyler: Beta sürücüsü Dev ya da Canary tarayıcıyı çalıştırabilmelidir.
3. Geri kalan her durumda, sürücüden eski bir Chrome da dahil, sonuç session not created olur.

Her durumu Chrome for Testing derlemeleri, Selenium 4.50.0 ve Python 3.13 ile Windows 11'de denedik:

İkinci satırda sürücü logu This version of ChromeDriver has not been tested with Chrome version 154. diyordu. Selenium bu logu siz istemedikçe göstermez; uyarı fark edilmeden kalır ve bir sonraki Chrome sürümü onu hataya çevirir. Google'ın ChromeDriver belgesi koddan daha katıdır: ana, ara ve derleme numaralarının üçünün de eşleşmesini ister.

Hata neden tekrar tekrar geliyor?#

Chrome kendini günceller: yeni sürüm arka planda iner ve tarayıcı bir sonraki açılışında devreye girer. Selenium da her oturum için yeni bir Chrome başlatır. İndirdiğiniz chromedriver ise sıradan bir çalıştırılabilir dosyadır ve onu güncelleyen hiçbir şey yoktur.

Chrome 153'ten beri bu daha sık oluyor. Google 8 Eylül 2026'da masaüstü, Android ve iOS için Chrome'u iki haftalık kararlı sürüm döngüsüne geçirdi. 154 sürümü 22 Eylül'de, 155 sürümü 6 Ekim'de çıktı; 156'nın çıkışı 20 Ekim'e planlandı. Bir sürümlük tolerans sayesinde, çıktığı gün Chrome'a uyan bir sürücü bir sonraki sürümü atlatır, ondan sonrakinde düşer. Sürücünün kullanım ömrü böylece sekiz haftadan yaklaşık dört haftaya indi. Extended Stable kanalındaki kurumlar ise yeni ana sürümü hâlâ sekiz haftada bir alıyor.

İki numarayı kendiniz görmek için Chrome'da sağ üstteki Diğer düğmesini tıklayın, ardından Yardım > Google Chrome hakkında'yı seçin. Sürücünün sürümü için onu --version ile çalıştırın:

> chromedriver --version
ChromeDriver 152.0.7977.82 (d04cdb24d67b081f6cf80200ffc5233f44b61109-refs/branch-heads/7977@{#2322})

Selenium hangi chromedriver'ı başlatacağını nasıl seçer?#

"Dün çalışıyordu" vakalarının çoğu, Selenium'un hangi sürücü dosyasını seçtiğiyle ilgilidir. Selenium 4.50 ile yaptığımız denemelerde webdriver.Chrome() sürücüyü şu sırayla aradı:

1. Service(executable_path=...) ile verilen yol. Selenium bu dosyayı olduğu gibi kullanır, sürümüne hiç bakmaz.
2. PATH üzerindeki bir chromedriver. PATH, sistemin program ararken baktığı klasörlerin listesidir. Selenium Manager bu kopyayı sürümler uyuşmasa bile kullanır, yalnızca uyarı yazar.
3. Selenium Manager'ın indirdiği sürücü. Açacağı Chrome'un sürümünü okur, uyan sürücüyü Chrome for Testing'de bulur ve ~/.cache/selenium klasöründe saklar.

Selenium Manager, 4.6 sürümünden beri resmî Selenium paketlerinin hepsinin içinde gelen yardımcı bir programdır; Python, Java, C#, Ruby ve JavaScript'te aynı şekilde çalışır. Selenium Manager belgesi ayarlarını sıralar; her ayarın SE_ ile başlayan bir ortam değişkeni karşılığı da vardır.

1. çözüm: sabit sürücü yolunu kaldırın#

Eski rehberler ChromeDriver'ı elle indirip yolunu koda yazar. Bu yol bir sonraki Chrome güncellemesinde uyumunu kaybeder:

from selenium import webdriver
from selenium.webdriver.chrome.service import Service

# Önce: Chrome güncellenince eskiyen sabit bir dosya
service = Service(executable_path=r"C:\tools\chromedriver.exe")
driver = webdriver.Chrome(service=service)

# Sonra: yol yok, Selenium Manager kurulu Chrome'a uyan sürücüyü getirir
driver = webdriver.Chrome()

Önce pip show selenium ile kurulu sürümü kontrol edin: 4.6'dan eski sürümlerde Selenium Manager yoktur, güncel sürüm 4.50.0 ise 30 Eylül 2026'da çıktı. Denememizde ikinci biçim, ilk çalıştırmada Chrome 154.0.8037.92 için ChromeDriver 154.0.8037.92'yi indirdi, sonraki çalıştırmalarda da aynısını kullandı.

İndirme için internet erişimi gerekir. Şirket proxy'sinin arkasındaysanız proxy adresini SE_PROXY değişkenine yazın; internete hiç çıkmayan bir makinede iki dosyayı 3. çözümdeki gibi kendiniz sağlayın. Chrome 115 ve sonrasının sürücüleri yalnızca Chrome for Testing'de yayımlanıyor; önceki ChromeDriver depolama sitesini okuyan eski bir indirme betiği bu yüzden 114'te kalır.

2. çözüm: PATH üzerindeki eski chromedriver'ı silin#

Selenium Manager bu durumu tek başına çözemez. PATH üzerindeki bir klasörde, örneğin bir araçlar klasöründe ya da Python'un Scripts klasöründe eski bir chromedriver.exe duruyorsa Selenium Manager onu kullanır ve uyarır. PATH üzerinde ChromeDriver 152, makinede Chrome 154 varken yaptığımız denemede istisnadan önce şu satır çıktı:

The chromedriver version (152.0.7977.82) detected in PATH at ...\chromedriver.exe might not be compatible with the detected chrome version (154.0.8037.92); currently, chromedriver 154.0.8037.92 is recommended for chrome 154.*, so it is advised to delete the driver in PATH and retry

Bütün kopyaları Windows'ta where.exe chromedriver, macOS ve Linux'ta which -a chromedriver ile bulun, sonra dosyayı silin ya da klasörünü PATH'ten çıkarın. Ortak bir derleme sunucusu gibi makineye dokunamadığınız yerlerde SE_SKIP_DRIVER_IN_PATH=true ayarlayın. Denememizde Selenium Manager bu ayarla eski kopyayı yok saydı, 154 sürücüsünü indirdi ve oturum başladı.

3. çözüm: Chrome ve ChromeDriver'ı Chrome for Testing ile sabitleyin#

İlk iki çözüm kurulu Chrome'u izler; geliştirici makinesi için doğru olan budur. Zamanlanmış işler ve test paketleri ise çoğu zaman tersini ister: her çalıştırmada aynı tarayıcı, güncellemesi de sizin seçtiğiniz zamanda. Chrome for Testing bunun için yapılmış bir Chrome derlemesidir. Kendini güncellemez ve her sürümü aynı numaralı ChromeDriver ile birlikte yayımlanır. Selenium Manager'la sabitlemek tek bir seçenek ister:

from selenium import webdriver

options = webdriver.ChromeOptions()
options.browser_version = "153"  # Chrome for Testing 153 ve ChromeDriver 153
driver = webdriver.Chrome(options=options)
print(driver.capabilities["browserVersion"])  # denememizde 153.0.8010.52
driver.quit()

Kurulu Chrome'un ana sürümü farklıysa Selenium Manager Chrome for Testing 153'ü sürücünün yanına, önbelleğine indirir; kurulu Chrome zaten 153 ise onu kullanır. SE_FORCE_BROWSER_DOWNLOAD=true her zaman indirilen derlemeyi kullandırır, SE_CACHE_PATH ise önbelleği örneğin proje klasörüne taşır.

Çevrimdışı bir makinede ya da bir Docker imajında tarayıcı ve sürücü arşivlerini Chrome for Testing panosunun aynı sürüm satırından indirin, Selenium'u options.binary_location ve Service(executable_path=...) ile onlara yönlendirin. Burada sabit yol sorun değildir, çünkü yanındaki tarayıcı kendini güncelleyemez.

webdriver-manager, Docker ve CI#

Eski Python projeleri webdriver-manager paketinden ChromeDriverManager().install() çağırır; paketin README dosyası artık Selenium 4.6+ için Selenium Manager'ı öneriyor. Paket, .wdm klasörüne indirdiği sürücüleri varsayılan olarak bir gün geçerli sayar; driver_version="..." ise Chrome ilerlerken sürücüyü dondurur. Bu argümanı kaldırın ya da çağrının yerine 1. çözümü koyun.

Konteynerler ve derleme sunucuları genellikle yeniden derlemeden sonra bozulur:

• Güncel Chrome'u ve sabit bir sürücüyü kuran Dockerfile. apt-get install google-chrome-stable derleme günü güncel olanı kurar, sürüm numaralı bir URL'den indirilen chromedriver ise aynı sürümde kalır. İkisini aynı Chrome for Testing sürümünden kurun ya da sürücüyü çalışma anında Selenium Manager'a getirtin.
• Selenium'un Docker imajları. selenium/standalone-chrome etiketleri iki sürümü de adında taşır, örneğin 153.0-chromedriver-153.0-20260909; imajın içinde tarayıcı ve sürücü hep uyuşur. Proje latest yerine tam etiket kullanmanızı öneriyor.
• GitHub'ın barındırdığı runner'lar. Ubuntu imajları Chrome'u, ona uyan bir ChromeDriver ile birlikte getirir ve sürücüyü PATH üzerindeki /usr/bin klasörüne bağlar. Bir iş akışı adımı başka bir Chrome kurarsa bu sürücü artık uyuşmaz; SE_SKIP_DRIVER_IN_PATH=true ayarlayın ya da sürücüyü tarayıcıyla aynı kaynaktan kurun.

Edge'de aynı hata ve Playwright'ta neden görülmediği#

Edge, Chromium üzerine kuruludur ve sürücüsü msedgedriver (Microsoft Edge WebDriver) bir Edge güncellemesinden sonra aynı biçimde düşer: This version of Microsoft Edge WebDriver only supports Microsoft Edge version 122, ardından Current browser version is 124.0.2478.80. Microsoft'un WebDriver belgesi sürüm numarasının ilk üç parçası Edge ile eşleşen bir sürücü ister; Edge sürümünü edge://settings/help sayfasında gösterir. Çözümler aynen geçerlidir: Selenium Manager webdriver.Edge() için msedgedriver'ı indirir, PATH üzerindeki eski bir kopya da eski chromedriver gibi önüne geçer.

Playwright bu sorundan tasarım gereği kaçınır. Her Playwright sürümü, playwright install komutunun indirdiği belirli tarayıcı derlemelerine bağlıdır; tarayıcıyla birlikte güncel tutulması gereken ayrı bir sürücü dosyası yoktur. Onun karşılığı olan hata, kütüphane güncellemesinden sonra gelen "Executable doesn't exist" hatasıdır ve playwright install yeniden çalıştırılınca geçer. İki haftalık Chrome döngüsü size aracı yeniden düşündürüyorsa Playwright ve Selenium karşılaştırmamız aynı işi iki araçla da yapıyor.

Eski sürücüyü adıyla gösteren bir Python betiği#

Betik, Chrome'u 1. çözümün önerdiği gibi başlatır ve bir sürüm uyuşmazlığını hangi dosyanın kaldırılacağını söyleyen iki satıra çevirir. İki ana sürümü mesajdan okur, PATH üzerindeki bir chromedriver'ın kullanılıp kullanılmadığına bakar ve başka nedenli her session not created hatasını olduğu gibi yeniden fırlatır.

"""Chrome'u Selenium ile başlatır, sürücü/tarayıcı sürüm uyuşmazlığını açıklar."""
import os
import re
import shutil
import sys

from selenium import webdriver
from selenium.common.exceptions import SessionNotCreatedException
from selenium.webdriver.chrome.service import Service

MISMATCH = re.compile(
    r"only supports Chrome version (?P<driver>\d+)\s+"
    r"Current browser version is (?P<browser>\d+)"
)


def start_chrome(browser_version=None, binary=None, driver_path=None, headless=True):
    """Chrome sürücüsü döndürür; uyuşmazlıkta hangi sürücünün eskidiğini yazıp çıkar."""
    options = webdriver.ChromeOptions()
    if browser_version:  # ör. "154": Selenium Manager o Chrome for Testing'i ve sürücüsünü getirir
        options.browser_version = browser_version
    if binary:  # kendi açtığınız bir Chrome for Testing derlemesi
        options.binary_location = binary
    if headless:
        options.add_argument("--headless")
    service = Service(executable_path=driver_path) if driver_path else None

    try:
        driver = webdriver.Chrome(options=options, service=service)
    except SessionNotCreatedException as exc:
        found = MISMATCH.search(exc.msg or "")
        if not found:
            raise  # başka nedenli "session not created": mesajın tamamını okuyun
        print(f"ChromeDriver {found['driver']} cannot drive Chrome {found['browser']}.")
        on_path = shutil.which("chromedriver")
        if driver_path:
            print(f"The fixed path is stale: {driver_path}")
            print("Remove driver_path and let Selenium Manager pick the driver.")
        elif on_path:
            print(f"Selenium used the chromedriver on PATH: {on_path}")
            print("Delete that file (or set SE_SKIP_DRIVER_IN_PATH=true) and run again.")
        sys.exit(1)

    caps = driver.capabilities
    driver_version = caps["chrome"]["chromedriverVersion"].split(" ")[0]
    print(f"Chrome {caps['browserVersion']} with ChromeDriver {driver_version}")
    return driver


if __name__ == "__main__":
    driver = start_chrome(
        browser_version=os.environ.get("CHROME_VERSION"),
        binary=os.environ.get("CHROME_BINARY"),
        driver_path=os.environ.get("CHROMEDRIVER_PATH"),
    )
    try:
        driver.get("https://example.com/")
        print(driver.title)
    finally:
        driver.quit()

Betik için yalnızca pip install selenium yeterli; ortam değişkeni verilmezse kurulu Chrome'u başlatır. Betiğin ekrana yazdığı satırları, aşağıdaki gerçek çıktıyla aynı kalsın diye İngilizce bıraktık.

Çıktı nasıl görünüyor?#

Betiği Windows 11'de Selenium 4.50.0 ile beş kez çalıştırdık; 1, 2, 3 ve 5. çalıştırmalarda CHROME_BINARY Chrome for Testing 154'ü gösteriyordu, Selenium Manager önbelleği de proje klasöründeydi. # ile başlayan satırlar bizim etiketlerimiz, yollar kısaltıldı:

# 1. ChromeDriver 152 on PATH
The chromedriver version (152.0.7977.82) detected in PATH at ...\chromedriver.exe might not be compatible with the detected chrome version (154.0.8037.92); currently, chromedriver 154.0.8037.92 is recommended for chrome 154.*, so it is advised to delete the driver in PATH and retry
ChromeDriver 152 cannot drive Chrome 154.
Selenium used the chromedriver on PATH: ...\152.0.7977.82\chromedriver-win64\chromedriver.EXE
Delete that file (or set SE_SKIP_DRIVER_IN_PATH=true) and run again.

# 2. CHROMEDRIVER_PATH set to ChromeDriver 152
ChromeDriver 152 cannot drive Chrome 154.
The fixed path is stale: ...\152.0.7977.82\chromedriver-win64\chromedriver.exe
Remove driver_path and let Selenium Manager pick the driver.

# 3. No driver anywhere: Selenium Manager downloads 154
Chrome 154.0.8037.92 with ChromeDriver 154.0.8037.92
Example Domain

# 4. CHROME_VERSION=153 (with SE_FORCE_BROWSER_DOWNLOAD=true)
Chrome 153.0.8010.52 with ChromeDriver 153.0.8010.52
Example Domain

# 5. Run 1 again with SE_SKIP_DRIVER_IN_PATH=true
Chrome 154.0.8037.92 with ChromeDriver 154.0.8037.92
Example Domain

Birinci çalıştırmanın ilk satırı Selenium Manager'ın kendi uyarısıdır; Python bunu logging modülü üzerinden yazar.

Sürümle ilgisi olmayan "session not created" mesajları#

Her session not created sürümden kaynaklanmaz. Denemelerimiz sırasında iki tanesiyle daha karşılaştık; betik bunları değiştirmeden geçirir:

Bu hatayla nerelerde karşılaşırsınız?#

• Gözetimsiz çalışan zamanlanmış scraping (veri kazıma) işleri ve fiyat takibi: Chrome güncellemesinden sonraki ilk çalıştırma, daha tek sayfa açılmadan düşer.
• Geliştirici bilgisayarlarındaki test paketleri: eski bir kurulum rehberinden kalan sürücü hâlâ PATH üzerindedir.
• CI hatları: runner imajı ya da Docker taban imajı değiştikten sonra.
• Ortak sunucular: yıllar önce biri chromedriver'ı herkes için kurmuştur.

Sürüm kontrolü Chrome tek bir sayfa yüklemeden önce yapılır, bu yüzden nedeni hiçbir zaman ağ değildir. Bir Datacenter Proxy arkasındaki scraper da ev bağlantısındaki bir scraper gibi aynı hatayı alır; proxy'yi değiştirmek sonucu değiştirmez.

Sık yapılan hatalar#

• Yeni indirilen sürücünün yolunu yine koda yazmak. Chrome iki sürüm ilerleyene kadar, yani artık yaklaşık dört hafta çalışır.
• Yanlış kopyayı güncellemek. PATH sırasında daha önde eski bir kopya durdukça başka klasördeki yeni sürücü işe yaramaz.
• Günlük kullandığınız Chrome'u eski sürücüye uydurmak için geri almak. Güvenlik düzeltmelerinden vazgeçmiş olursunuz; eski bir tarayıcı gerekiyorsa Chrome for Testing kullanın.
• Bir sürümlük toleransa güvenmek. Uyarı kimsenin okumadığı bir loga düşer.
• ChromeDriver'a --disable-build-check eklemek. Desteklenmeyen bu anahtar karşılaştırmayı atlar ve sürücü, yalnızca onunla görülen hataların bildirilmemesini isteyen bir uyarı yazar. Uyuşmazlığı çözmez, gizler.

Karar rehberi#

Sıkça sorulan sorular#

Hiçbir şeyi değiştirmediğim hâlde ChromeDriver neden çalışmayı bıraktı?#

Chrome kendini güncelledi ve güncelleme bir sonraki açılışta devreye girdi, chromedriver dosyası ise eski sürümünde kaldı. Tarayıcı sürücüden iki ana sürüm öne geçtiğinde ya da sürücü tarayıcıdan yeni olduğunda oturum reddedilir.

ChromeDriver 153, Chrome 154'ü çalıştırabilir mi?#

Evet, sürücü logunda bir uyarıyla; denememizde oturum normal başladı. ChromeDriver 153, Chrome 155'i ve 153'ten eski her sürümü reddeder.

Selenium Manager indirdiği sürücüleri nereye kaydeder?#

Ev klasörünüzdeki ~/.cache/selenium altına; sürücü, platform ve sürüme göre ayrılmış olarak, indirdiği Chrome for Testing derlemeleriyle birlikte. Önbelleği proje klasöründe tutmak için SE_CACHE_PATH ayarlayın.

Sürücü uyumlu kalsın diye Chrome'un güncellenmesini durdurmalı mıyım?#

Her gün kullandığınız tarayıcıda hayır, çünkü güncellemeler güvenlik düzeltmeleri taşır. Değişmemesi gereken testler için Chrome for Testing kullanın: kendini hiç güncellemez, yeni sürüme ne zaman geçeceğinize siz karar verirsiniz.

Proxy "session not created" hatasına yol açar mı?#

Hayır. ChromeDriver sürümleri Chrome herhangi bir sayfayı açmadan önce karşılaştırır; --proxy-server argümanı yalnızca sonraki trafiği etkiler. Yine de şirket proxy'si Selenium Manager'ın indirmesini engelleyebilir; indirmenin proxy üzerinden gitmesi için SE_PROXY ayarlayın.

Aynı çözüm Java, C# ve JavaScript'te de işe yarar mı?#

Evet. Selenium Manager 4.6'dan beri resmî Selenium paketlerinin hepsiyle gelir: Java'da System.setProperty("webdriver.chrome.driver", ...) satırını kaldırın, C# ve JavaScript'te sürücü yolu vermeyi bırakın.

Özet#

"This version of ChromeDriver only supports Chrome version N", Chrome'un kendini güncellediğini, sürücü dosyasınınsa güncellenmediğini söyler. ChromeDriver aynı ana sürümü kabul eder, bir sürüm yenisini de uyarıyla kabul eder; bu yüzden Chrome'un iki haftalık döngüsünde dondurulmuş bir sürücü yaklaşık dört hafta dayanır. Sabit sürücü yollarını ve PATH üzerindeki eski kopyaları kaldırın, sürücüyü Selenium Manager eşlesin; çalıştırmaların aynı kalması gereken yerde ikisini Chrome for Testing ile sabitleyin.

Oturum yeniden başladığında scraping işlerinin çoğunda sıradaki adım ağ ayarıdır; Selenium ile proxy kullanımı rehberimiz Chrome, Edge, kimlik doğrulama ve SOCKS5'i anlatıyor.

Ziyaretçiyi IP adresinin itibarına göre değerlendiren sitelerde bu trafiği, ev bağlantıları üzerinden çıkan bir Residential Proxy ile gönderin.