ChromeDriver-Version passt nicht zu Chrome: Fehler beheben

Ihr Selenium-Job lief am Freitag ohne Probleme. Am Montag bricht schon seine erste Zeile, webdriver.Chrome(), mit einer SessionNotCreatedException und zwei Zeilen Text ab: This version of ChromeDriver only supports Chrome version 152 und Current browser version is 154.0.8037.92. Am Code hat niemand etwas geändert. Chrome hat sich über das Wochenende selbst aktualisiert, und die chromedriver-Datei auf der Festplatte ist geblieben, wie sie war.

Diese Anleitung liest die Meldung, zeigt die Regel, nach der ChromeDriver entscheidet (direkt aus seinem Quellcode), und erklärt, warum der Fehler inzwischen alle paar Wochen wiederkommt. Danach folgen die Lösungen: Selenium Manager, ein veralteter Treiber im PATH, Chrome for Testing, Docker und CI, derselbe Fehler in Edge und ein getestetes Python-Skript, das den veralteten Treiber benennt.

Was bedeutet „This version of ChromeDriver only supports Chrome version“?#

ChromeDriver ist ein kleines Programm zwischen Selenium und Chrome: Selenium schickt ihm standardisierte WebDriver-Befehle wie „öffne diese URL“, und ChromeDriver übersetzt sie in Befehle, die Chrome versteht. Jeder Build stammt aus demselben Quellcode-Stand wie ein bestimmtes Chrome-Release und trägt dessen Versionsnummer.

Eine Sitzung (Session) ist ein Browser, den Ihr Code bis quit() steuert; „session not created“ heißt, dass es gar nicht so weit kam. So sah die Ausgabe von Selenium 4.50 in unserem Test mit ChromeDriver 152 und einem Test-Build von Chrome 154 aus (Pfad gekürzt, Stacktrace abgeschnitten):

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

Die Meldung besteht aus drei Teilen:

• only supports Chrome version 152 ist die Hauptversion des Treibers, den Selenium gestartet hat.
• Current browser version is 154.0.8037.92 ist die vollständige Version des Chrome, das dieser Treiber geöffnet hat.
• with binary path nennt die Chrome-Datei. Auf einem Rechner mit Chrome, Chrome Beta und einem Test-Build sehen Sie hier, welcher davon gewählt wurde.

Der Text stammt von ChromeDriver selbst, nicht vom Python-Paket; Java, C# und JavaScript zeigen deshalb dieselben zwei Zeilen in ihrer eigenen Exception. Der Stacktrace darunter gehört zum Treiber und hilft bei diesem Fehler nicht weiter.

Welche Chrome-Versionen akzeptiert ein ChromeDriver?#

Die Prüfung ist eine kurze Funktion namens CheckVersion im Launcher-Quellcode von ChromeDriver. Sie vergleicht nur die erste Zahl der beiden Versionen:

1. Gleiche Hauptversion: Die Sitzung startet.
2. Chrome genau eine Hauptversion neuer als der Treiber: Die Sitzung startet, und der Treiber schreibt eine Warnung in sein Log. Ein Kommentar im Quellcode nennt den Grund: Ein Beta-Treiber soll einen Dev- oder Canary-Browser steuern können.
3. Alles andere, auch ein Chrome, das älter ist als der Treiber: session not created.

Wir haben jeden Fall mit Chrome-for-Testing-Builds, Selenium 4.50.0 und Python 3.13 unter Windows 11 getestet:

In der zweiten Zeile meldete das Treiber-Log This version of ChromeDriver has not been tested with Chrome version 154. Selenium blendet dieses Log aus, solange Sie es nicht anfordern. Die Warnung bleibt also unbemerkt, bis das nächste Chrome-Release aus ihr einen Fehler macht. Die ChromeDriver-Dokumentation von Google ist strenger als der Code und verlangt übereinstimmende Haupt-, Neben- und Build-Nummern.

Warum kommt der Fehler immer wieder?#

Chrome aktualisiert sich selbst: Die neue Version wird im Hintergrund geladen und gilt ab dem nächsten Browserstart, und Selenium startet für jede Sitzung ein frisches Chrome. Ein chromedriver, den Sie heruntergeladen haben, ist dagegen eine gewöhnliche ausführbare Datei, und nichts aktualisiert sie.

Seit Chrome 153 passiert das häufiger. Google hat Chrome am 8. September 2026 auf Desktop, Android und iOS auf einen zweiwöchigen Stable-Zyklus umgestellt: Chrome 154 erschien am 22. September, 155 am 6. Oktober, und 156 ist für den 20. Oktober geplant. Mit der Toleranz von einer Version übersteht ein Treiber, der am Erscheinungstag zu Chrome passte, ein Release und scheitert am nächsten. Seine Lebensdauer beträgt damit nur noch etwa vier statt acht Wochen. Unternehmen im Kanal Extended Stable bekommen weiterhin nur alle acht Wochen eine neue Hauptversion.

Um beide Nummern selbst zu sehen, öffnen Sie Chrome und wählen Dreipunkt-Menü > Hilfe > Über Google Chrome. Den Treiber starten Sie dafür mit --version:

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

Wie wählt Selenium den chromedriver aus, den es startet?#

Die meisten „Gestern lief es noch“-Fälle hängen daran, welche Treiberdatei Selenium gewählt hat. Mit Selenium 4.50 suchte webdriver.Chrome() in dieser Reihenfolge:

1. Ein Pfad aus Service(executable_path=...). Selenium verwendet diese Datei unverändert und prüft ihre Version nie.
2. Ein chromedriver im PATH, der Liste der Ordner, in denen das System nach Programmen sucht. Selenium Manager verwendet diese Kopie auch dann, wenn die Versionen nicht passen, und gibt nur eine Warnung aus.
3. Ein von Selenium Manager heruntergeladener Treiber. Selenium Manager liest die Version des Chrome, das gleich starten soll, sucht den passenden Treiber bei Chrome for Testing und legt ihn in ~/.cache/selenium ab.

Selenium Manager ist ein Hilfsprogramm, das seit Version 4.6 in jedem offiziellen Selenium-Paket steckt; es verhält sich deshalb in Python, Java, C#, Ruby und JavaScript gleich. Die Dokumentation zu Selenium Manager listet seine Einstellungen auf; zu jeder gibt es auch eine Umgebungsvariable, die mit SE_ beginnt.

Lösung 1: den festen Treiberpfad entfernen#

Ältere Anleitungen laden ChromeDriver von Hand herunter und übergeben seinen Speicherort. Dieser Pfad passt nach dem nächsten Chrome-Update nicht mehr:

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

# Vorher: eine feste Datei, die nach einem Chrome-Update veraltet
service = Service(executable_path=r"C:\tools\chromedriver.exe")
driver = webdriver.Chrome(service=service)

# Nachher: kein Pfad, Selenium Manager holt den Treiber für das installierte Chrome
driver = webdriver.Chrome()

Prüfen Sie zuerst mit pip show selenium die installierte Version: Alles vor 4.6 hat keinen Selenium Manager, und das aktuelle Release 4.50.0 erschien am 30. September 2026. In unserem Test lud die zweite Variante beim ersten Lauf ChromeDriver 154.0.8037.92 für Chrome 154.0.8037.92 herunter und verwendete ihn danach wieder.

Der Download braucht Internetzugang. Hinter einem Firmen-Proxy tragen Sie die Proxy-Adresse in SE_PROXY ein; auf einem Rechner ganz ohne Internet stellen Sie beide Dateien selbst bereit, wie in Lösung 3. Treiber für Chrome 115 und neuer erscheinen nur noch bei Chrome for Testing. Ein altes Download-Skript, das die frühere ChromeDriver-Downloadseite ausliest, bleibt deshalb bei Version 114 stehen.

Lösung 2: den alten chromedriver im PATH löschen#

Diesen Fall löst Selenium Manager nicht allein. Liegt eine alte chromedriver.exe in einem Ordner im PATH, etwa in einem Tools-Ordner oder im Scripts-Ordner von Python, verwendet Selenium Manager sie und warnt nur. Mit ChromeDriver 152 im PATH und Chrome 154 gab unser Lauf vor der Exception diese Zeile aus:

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

Finden Sie jede Kopie mit where.exe chromedriver unter Windows oder which -a chromedriver unter macOS und Linux. Löschen Sie dann die Datei, oder nehmen Sie ihren Ordner aus dem PATH. Können Sie den Rechner nicht ändern, etwa auf einem gemeinsam genutzten Build-Server, setzen Sie SE_SKIP_DRIVER_IN_PATH=true. In unserem Test ignorierte Selenium Manager daraufhin die veraltete Kopie, lud Treiber 154 herunter, und die Sitzung startete.

Lösung 3: Chrome und ChromeDriver mit Chrome for Testing fixieren#

Lösung 1 und 2 folgen dem installierten Chrome, und das passt zu einem Entwicklerrechner. Geplante Jobs und Testsuiten brauchen oft das Gegenteil: bei jedem Lauf denselben Browser, aktualisiert erst dann, wenn Sie es entscheiden. Chrome for Testing ist ein Chrome-Build genau für diesen Zweck. Es aktualisiert sich nicht selbst, und jede Version erscheint zusammen mit dem ChromeDriver derselben Nummer. Mit Selenium Manager braucht das Fixieren nur eine Option:

from selenium import webdriver

options = webdriver.ChromeOptions()
options.browser_version = "153"  # Chrome for Testing 153 und ChromeDriver 153
driver = webdriver.Chrome(options=options)
print(driver.capabilities["browserVersion"])  # in unserem Test 153.0.8010.52
driver.quit()

Hat das installierte Chrome eine andere Hauptversion, lädt Selenium Manager Chrome for Testing 153 neben den Treiber in seinen Cache; ist das installierte Chrome bereits 153, verwendet er dieses. Mit SE_FORCE_BROWSER_DOWNLOAD=true nimmt er immer den heruntergeladenen Build, und SE_CACHE_PATH verlegt den Cache, zum Beispiel in den Projektordner.

Für einen Offline-Rechner oder ein Docker-Image laden Sie die Archive von Browser und Treiber aus derselben Versionszeile des Chrome-for-Testing-Dashboards herunter und verweisen Selenium mit options.binary_location und Service(executable_path=...) darauf. Hier ist ein fester Pfad in Ordnung, denn der Browser daneben kann sich nicht aktualisieren.

webdriver-manager, Docker und CI#

Ältere Python-Projekte rufen ChromeDriverManager().install() aus dem Paket webdriver-manager auf, dessen README inzwischen Selenium Manager für Selenium 4.6+ empfiehlt. Das Paket hält Treiber standardmäßig einen Tag lang in einem .wdm-Ordner vor, und driver_version="..." friert den Treiber ein, während Chrome weiterzieht. Entfernen Sie dieses Argument, oder ersetzen Sie den Aufruf durch Lösung 1.

Container und Build-Server gehen meist nach einem Neubau des Images kaputt:

• Ein Dockerfile mit aktuellem Chrome und festem Treiber. apt-get install google-chrome-stable installiert, was am Build-Tag aktuell ist, während ein chromedriver von einer URL mit fester Versionsnummer stehen bleibt. Installieren Sie beide aus derselben Chrome-for-Testing-Version, oder lassen Sie Selenium Manager den Treiber zur Laufzeit holen.
• Die Docker-Images von Selenium. Die Tags von selenium/standalone-chrome nennen beide Versionen, zum Beispiel 153.0-chromedriver-153.0-20260909; Browser und Treiber passen im Image also zusammen. Das Projekt empfiehlt einen vollständigen Tag statt latest.
• Von GitHub gehostete Runner. Die Ubuntu-Images bringen Chrome mit einem passenden ChromeDriver mit, der nach /usr/bin verlinkt ist und damit im PATH liegt. Installiert ein Workflow-Schritt ein anderes Chrome, passt dieser Treiber nicht mehr; setzen Sie SE_SKIP_DRIVER_IN_PATH=true, oder installieren Sie den Treiber aus derselben Quelle wie den Browser.

Derselbe Fehler in Edge und warum Playwright ihn vermeidet#

Edge basiert auf Chromium, und sein Treiber msedgedriver (Microsoft Edge WebDriver) scheitert nach einem Edge-Update genauso: This version of Microsoft Edge WebDriver only supports Microsoft Edge version 122, gefolgt von Current browser version is 124.0.2478.80. Die WebDriver-Dokumentation von Microsoft verlangt einen Treiber, dessen erste drei Versionsteile mit Edge übereinstimmen; Edge zeigt seine Version unter edge://settings/help. Die Lösungen lassen sich übertragen: Selenium Manager lädt msedgedriver für webdriver.Edge() herunter, und eine alte Kopie im PATH steht ihm genauso im Weg wie ein alter chromedriver.

Playwright vermeidet das Problem schon durch seinen Aufbau. Jedes Playwright-Release ist an bestimmte Browser-Builds gebunden, die playwright install herunterlädt; es gibt also keine separate Treiberdatei, die mit dem Browser Schritt halten muss. Sein Gegenstück ist der Fehler „Executable doesn't exist“ nach einem Update der Bibliothek, den ein erneutes playwright install behebt. Wenn Sie wegen des zweiwöchigen Chrome-Zyklus über das Werkzeug nachdenken: Unser Vergleich von Playwright und Selenium erledigt dieselbe Aufgabe mit beiden.

Ein Python-Skript, das den veralteten Treiber benennt#

Das Skript startet Chrome so, wie Lösung 1 es empfiehlt, und macht aus einem Versionskonflikt zwei Zeilen, die sagen, welche Datei weg muss. Es liest beide Hauptversionen aus der Meldung, prüft, ob ein chromedriver aus dem PATH verwendet wurde, und reicht jeden anderen session not created-Fehler unverändert weiter.

"""Startet Chrome mit Selenium und erklärt einen Versionskonflikt zwischen Treiber und Browser."""
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):
    """Gibt einen Chrome-Treiber zurück; bei einem Versionskonflikt den veralteten Treiber nennen und beenden."""
    options = webdriver.ChromeOptions()
    if browser_version:  # z. B. "154": Selenium Manager holt dieses Chrome for Testing samt Treiber
        options.browser_version = browser_version
    if binary:  # ein Chrome-for-Testing-Build, den Sie selbst entpackt haben
        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  # "session not created" aus einem anderen Grund: die ganze Meldung lesen
        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()

Das Skript braucht nur pip install selenium; ohne Umgebungsvariablen startet es das installierte Chrome. Die Ausgaben des Skripts haben wir auf Englisch gelassen, damit sie mit der echten Ausgabe unten übereinstimmen.

So sieht die Ausgabe aus#

Wir haben es fünfmal unter Windows 11 mit Selenium 4.50.0 ausgeführt, mit Chrome for Testing 154 in CHROME_BINARY (Läufe 1, 2, 3 und 5) und dem Cache von Selenium Manager im Projektordner. Zeilen, die mit # beginnen, sind unsere Beschriftungen; Pfade sind gekürzt:

# 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

Die erste Zeile von Lauf 1 ist die eigene Warnung von Selenium Manager, die über das logging-Modul von Python ausgegeben wird.

Andere „session not created“-Meldungen#

Nicht jedes session not created hat mit Versionen zu tun. Zwei weitere Meldungen tauchten in unseren Tests auf, und das Skript reicht sie unverändert weiter:

Wo dieser Fehler auftritt#

• Geplante Scraper und Preisprüfungen, die unbeaufsichtigt laufen: Der erste Lauf nach einem Chrome-Update scheitert, bevor irgendeine Seite lädt.
• Testsuiten auf Entwickler-Laptops, bei denen ein Treiber aus einer alten Einrichtungsanleitung noch im PATH liegt.
• CI-Pipelines, nachdem sich ein Runner-Image oder ein Docker-Basis-Image geändert hat.
• Gemeinsam genutzte Server, auf denen vor Jahren jemand chromedriver für alle installiert hat.

Die Versionsprüfung läuft, bevor Chrome auch nur eine Seite lädt; das Netzwerk ist also nie die Ursache. Ein Scraper hinter einem Datacenter-Proxy scheitert genauso wie einer an einem Heimanschluss, und ein anderer Proxy ändert daran nichts.

Häufige Fehler#

• Wieder einen frisch heruntergeladenen Treiber fest eintragen. Er funktioniert nur, bis Chrome zwei Versionen voraus ist, inzwischen also etwa vier Wochen.
• Die falsche Kopie aktualisieren. Ein neuerer Treiber in einem Ordner hilft nicht, solange ein älterer weiter vorn im PATH liegt.
• Das Chrome für den Alltag zurückstufen, damit es zu einem alten Treiber passt. Sie verzichten damit auf Sicherheitskorrekturen; für einen älteren Browser nehmen Sie Chrome for Testing.
• Sich auf die Toleranz von einer Version verlassen. Die Warnung landet in einem Log, das niemand liest.
• --disable-build-check an ChromeDriver übergeben. Dieser nicht unterstützte Schalter überspringt den Vergleich, und der Treiber warnt dann, dass Fehler, die nur mit diesem Schalter auftreten, nicht gemeldet werden sollen. Er versteckt den Konflikt, statt ihn zu beheben.

Entscheidungshilfe#

Häufige Fragen#

Warum funktioniert ChromeDriver nicht mehr, obwohl ich nichts geändert habe?#

Chrome hat sich selbst aktualisiert und das Update beim nächsten Start angewendet, während die chromedriver-Datei auf ihrer alten Version blieb. Sobald der Browser zwei Hauptversionen voraus ist oder der Treiber neuer ist als der Browser, wird die Sitzung abgelehnt.

Kann ChromeDriver 153 Chrome 154 steuern?#

Ja, mit einer Warnung im Treiber-Log; in unserem Test startete die Sitzung normal. ChromeDriver 153 lehnt Chrome 155 und alles unter 153 ab.

Wo speichert Selenium Manager die heruntergeladenen Treiber?#

In ~/.cache/selenium in Ihrem Benutzerordner, sortiert nach Treiber, Plattform und Version, zusammen mit allen Chrome-for-Testing-Builds, die er geholt hat. Mit SE_CACHE_PATH legen Sie den Cache stattdessen in einen Projektordner.

Sollte ich Chrome-Updates abschalten, damit der Treiber weiter passt?#

Nicht in dem Browser, den Sie täglich nutzen, denn Updates bringen Sicherheitskorrekturen. Für Tests, die sich nicht ändern dürfen, nehmen Sie Chrome for Testing: Es aktualisiert sich nie selbst, und Sie entscheiden, wann Sie auf eine neuere Version wechseln.

Kann ein Proxy „session not created“ auslösen?#

Nein. ChromeDriver vergleicht die Versionen, bevor Chrome eine Seite öffnet, und das Argument --proxy-server betrifft nur den Datenverkehr danach. Ein Firmen-Proxy kann allerdings den Download von Selenium Manager blockieren; setzen Sie SE_PROXY, damit der Download über diesen Proxy läuft.

Funktioniert dieselbe Lösung in Java, C# und JavaScript?#

Ja. Selenium Manager ist seit 4.6 in jedem offiziellen Selenium-Paket enthalten: In Java entfernen Sie System.setProperty("webdriver.chrome.driver", ...), in C# und JavaScript übergeben Sie keinen Treiberpfad mehr.

Fazit#

„This version of ChromeDriver only supports Chrome version N“ heißt: Chrome hat sich selbst aktualisiert, die Treiberdatei nicht. ChromeDriver akzeptiert dieselbe Hauptversion und, mit Warnung, eine Version neuer; im zweiwöchigen Chrome-Zyklus hält ein eingefrorener Treiber deshalb etwa vier Wochen. Entfernen Sie feste Treiberpfade und alte Kopien im PATH, lassen Sie Selenium Manager den Treiber abgleichen, und fixieren Sie beide mit Chrome for Testing, wo Läufe identisch bleiben müssen.

Startet die Sitzung wieder, ist bei den meisten Scraping-Jobs die Netzwerkeinrichtung der nächste Schritt; unsere Anleitung zum Einsatz eines Proxys mit Selenium behandelt Chrome, Edge, Anmeldung und SOCKS5.

Für Websites, die Besucher nach der Reputation ihrer IP-Adresse beurteilen, leiten Sie diesen Verkehr über einen Residential-Proxy, der über Heimanschlüsse ins Netz geht.