TASK-028: Add exception logging to fire-and-forget asyncio.create_task()
- Create logged_task() helper in backend/app/utils/async_utils.py to wrap fire-and-forget coroutines with exception logging - Ensures unhandled task exceptions are always logged to structlog instead of silently discarded (Python 3.11+ RuntimeWarning) - Update ban_service.py to use logged_task() for geo_cache.lookup_batch() background resolution - Add comprehensive tests for logged_task() in test_async_utils.py - Document fire-and-forget task conventions in Backend-Development.md The logged_task() wrapper catches any exception raised in a background task, logs it with full traceback context and task name, and never re-raises. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -5,8 +5,12 @@ from __future__ import annotations
|
||||
import asyncio
|
||||
import time
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
from unittest import mock
|
||||
|
||||
from app.utils.async_utils import run_blocking
|
||||
import pytest
|
||||
import structlog
|
||||
|
||||
from app.utils.async_utils import logged_task, run_blocking
|
||||
|
||||
|
||||
async def test_run_blocking_executes_callable_in_thread() -> None:
|
||||
@@ -46,3 +50,67 @@ async def test_run_blocking_does_not_block_event_loop() -> None:
|
||||
await asyncio.sleep(0)
|
||||
result = await task
|
||||
assert result == "done"
|
||||
|
||||
|
||||
async def test_logged_task_awaits_coroutine() -> None:
|
||||
"""logged_task should await and complete the coroutine."""
|
||||
|
||||
async def dummy_coro() -> str:
|
||||
await asyncio.sleep(0)
|
||||
return "result"
|
||||
|
||||
with mock.patch("app.utils.async_utils.log") as mock_log:
|
||||
await logged_task(dummy_coro(), "test_task")
|
||||
mock_log.exception.assert_not_called()
|
||||
|
||||
|
||||
async def test_logged_task_catches_exception_and_logs() -> None:
|
||||
"""logged_task should catch exceptions and log them with task_name context."""
|
||||
|
||||
class CustomError(Exception):
|
||||
pass
|
||||
|
||||
async def failing_coro() -> None:
|
||||
raise CustomError("task failed")
|
||||
|
||||
with mock.patch("app.utils.async_utils.log") as mock_log:
|
||||
await logged_task(failing_coro(), "failing_task")
|
||||
mock_log.exception.assert_called_once_with(
|
||||
"background_task_failed",
|
||||
task_name="failing_task",
|
||||
)
|
||||
|
||||
|
||||
async def test_logged_task_with_asyncio_create_task() -> None:
|
||||
"""logged_task should work correctly when wrapped with asyncio.create_task."""
|
||||
|
||||
results: list[str] = []
|
||||
|
||||
async def background_work() -> None:
|
||||
await asyncio.sleep(0.01)
|
||||
results.append("done")
|
||||
|
||||
with mock.patch("app.utils.async_utils.log"):
|
||||
task = asyncio.create_task(
|
||||
logged_task(background_work(), "bg_task"),
|
||||
name="bg_task",
|
||||
)
|
||||
await task
|
||||
assert results == ["done"]
|
||||
|
||||
|
||||
async def test_logged_task_preserves_exception_info() -> None:
|
||||
"""logged_task should preserve traceback when logging the exception."""
|
||||
|
||||
async def failing_coro() -> None:
|
||||
raise ValueError("original error message")
|
||||
|
||||
with mock.patch("app.utils.async_utils.log") as mock_log:
|
||||
await logged_task(failing_coro(), "test_task")
|
||||
mock_log.exception.assert_called_once()
|
||||
# Verify the exception context is logged (structlog.exception captures
|
||||
# the traceback automatically)
|
||||
args, kwargs = mock_log.exception.call_args
|
||||
assert args[0] == "background_task_failed"
|
||||
assert kwargs["task_name"] == "test_task"
|
||||
|
||||
|
||||
Reference in New Issue
Block a user