Handling Errors Gracefully with Asyncio Exceptions

Mar 25, 2024 ยท 2 min read

Asyncio provides an asynchronous programming framework in Python that allows you to write non-blocking and efficient I/O code. A key part of any application is properly handling errors and exceptions. When working with asyncio, there are some unique exception handling challenges to be aware of.

The Basics

Most exceptions raised in asyncio asynchronous coroutines and tasks can be handled normally using try/except blocks:

import asyncio

async def main():
        result = await some_api_call()
    except ValueError:
        print("Oops, invalid input")


This will catch a ValueError in the coroutine and handle it.


One special exception to watch out for is asyncio.CancelledError. This gets raised if a task or coroutine is cancelled:

import asyncio

async def main():
    task = asyncio.create_task(other_func())
    await asyncio.sleep(1)
        await task
    except asyncio.CancelledError:
        print("Task was cancelled")


So make sure to catch CancelledError if you anticipate tasks being cancelled.

Propagating Exceptions

Another common pitfall is exceptions not propagating back properly from tasks. Use asyncio.create_task(coro()) instead of asyncio.ensure_future(coro()) and await any spawned tasks to avoid this issue.

Overall, handling exceptions with asyncio does take some special care. Set up try/except blocks for expected errors, watch out for CancelledError, and properly await spawned tasks. With these tips, you can gracefully handle errors in your asynchronous code!

Browse by tags:

Browse by language:

The easiest way to do Web Scraping

Get HTML from any page with a simple API call. We handle proxy rotation, browser identities, automatic retries, CAPTCHAs, JavaScript rendering, etc automatically for you

Try ProxiesAPI for free

curl "http://api.proxiesapi.com/?key=API_KEY&url=https://example.com"

<!doctype html>
    <title>Example Domain</title>
    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />


Don't leave just yet!

Enter your email below to claim your free API key: