WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

TimeoutError / asyncio.TimeoutError — Überschreitung eines Zeitlimits

TimeoutError signalisiert, dass eine Operation ihr Zeitlimit überschritten hat. In Python 3.14 ist asyncio.TimeoutError ein veralteter Alias derselben Klasse und keine eigene Ausnahme. Fange TimeoutError ab und unterscheide eine Zeitüberschreitung von einem gewöhnlichen Aufgabenabbruch.

Version: Python 3.14; repository image, production runtime not attested

Syntax

try:
    async with asyncio.timeout(seconds):
        await operation()
except TimeoutError:
    ...

Der eingebaute TimeoutError ist eine Unterklasse von OSError; bei Systemfunktionen entspricht er dem Fehler errno.ETIMEDOUT. Auch die Zeitlimitmechanismen in asyncio verwenden ihn. Eine lange Laufzeit löst diese Ausnahme nicht automatisch aus: Das Limit muss von der verwendeten API oder ihrer Konfiguration vorgegeben sein.

Seit Python 3.11 ist asyncio.TimeoutError ein veralteter Alias des eingebauten TimeoutError. In Python 3.14 ergibt asyncio.TimeoutError is TimeoutError den Wert True. Verwende in neuem Code except TimeoutError:; für diese Namen brauchst du keine zwei Behandlungszweige.

asyncio.timeout(seconds) bricht die aktuelle Aufgabe ab, wenn das Limit abläuft, und wandelt das daraus entstehende asyncio.CancelledError beim Verlassen des Kontexts in TimeoutError um. Deshalb muss das abfangende except außerhalb des async with-Blocks stehen. Ein gewöhnlicher Aufgabenabbruch ist ein eigener Fall; unterdrücke asyncio.CancelledError nicht innerhalb der Operation.

Wenn das Zeitlimit abläuft, fordert asyncio.wait_for() den Abbruch der Operation an, auf die es wartet. Es wartet, bis der Abbruch abgeschlossen ist, sodass die gesamte Wartezeit das angegebene Limit überschreiten kann. Wird die Operation dadurch abgebrochen, löst asyncio.wait_for() TimeoutError aus. Fängt die erwartete Koroutine jedoch asyncio.CancelledError ab und gibt einen Wert zurück, gibt asyncio.wait_for() diesen Wert zurück. Eine während des Abbruchs ausgelöste Ausnahme kann weitergegeben werden. Fange die Ausnahme möglichst nahe an der Operation ab, deren Fehlschlagen du behandeln kannst.

In diesem Eintrag behandelte Referenzbezeichner: TimeoutError / asyncio.TimeoutError.

Beispiele

import asyncio

async def main():
    print(asyncio.TimeoutError is TimeoutError)
    event = asyncio.Event()
    try:
        async with asyncio.timeout(0):
            await event.wait()
    except TimeoutError:
        print("Timed out")

asyncio.run(main())

Ergebnis

True
Timed out

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen