CKTIS / Python
TimeoutError / asyncio.TimeoutError — przekroczenie limitu czasu
TimeoutError sygnalizuje przekroczenie limitu czasu operacji. W Python 3.14 asyncio.TimeoutError jest przestarzałym aliasem tej samej klasy, a nie osobnym wyjątkiem. Przechwytuj TimeoutError i odróżniaj przekroczenie limitu od zwykłego anulowania zadania.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
try:
async with asyncio.timeout(seconds):
await operation()
except TimeoutError:
...Wbudowany TimeoutError jest podklasą OSError; dla funkcji systemowych odpowiada błędowi errno.ETIMEDOUT. Używają go również mechanizmy limitów czasu w asyncio. Samo wykonanie operacji trwającej długo nie powoduje automatycznie tego wyjątku: limit musi wynikać z używanego API lub konfiguracji.
Od Python 3.11 asyncio.TimeoutError jest przestarzałym aliasem wbudowanego TimeoutError. W Python 3.14 wyrażenie asyncio.TimeoutError is TimeoutError daje True. W nowym kodzie używaj except TimeoutError:; nie potrzebujesz dwóch klauzul dla tych nazw.
asyncio.timeout(seconds) anuluje bieżące zadanie po przekroczeniu limitu i przekształca wynikający z tego asyncio.CancelledError w TimeoutError przy wyjściu z kontekstu. Dlatego umieść obsługujący go except poza blokiem async with. Zwykłe anulowanie zadania to odrębny przypadek; nie tłum wewnątrz operacji asyncio.CancelledError.
Po upływie limitu asyncio.wait_for() żąda anulowania operacji, na którą czeka. Czeka na zakończenie anulowania, więc łączny czas oczekiwania może przekroczyć podany limit. Jeśli operacja zakończy się wskutek tego anulowania, asyncio.wait_for() zgłosi TimeoutError. Jeśli jednak oczekiwana korutyna przechwyci asyncio.CancelledError i zwróci wartość, asyncio.wait_for() zwróci tę wartość. Wyjątek zgłoszony podczas anulowania może zostać przekazany dalej. Przechwytuj wyjątek możliwie blisko operacji, której niepowodzenie potrafisz obsłużyć.
Identyfikatory objęte tym wpisem: TimeoutError / asyncio.TimeoutError.
Przykłady
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())Wynik
True Timed out
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.