python system_error ai_generated true

运行时错误：生命周期协议错误：在'lifespan.startup.complete'之前收到了'lifespan.shutdown'

RuntimeError: Lifespan protocol error: received 'lifespan.shutdown' before 'lifespan.startup.complete'

ID: python/starlette-asgi-lifespan-error

其他格式: JSON · Markdown 中文 · English
80%修复率
81%置信度
0证据数
2024-09-14首次发现

版本兼容性

版本状态引入弃用备注
3.x active — — —

根因分析

ASGI服务器在启动完成前发送了关闭信号，通常是由于启动处理器中出现错误。

English

The ASGI server sent a shutdown signal before the startup completed, often due to an error in the startup handler.

generic

解决方案

  1. 90% 成功率 Fix the error in the startup handler 
    @app.on_event('startup')
async def startup():
    try:
        # initialization code
    except Exception as e:
        print(f"Startup error: {e}")
  2. 85% 成功率 Use try-except in lifespan context manager 
    @asynccontextmanager
async def lifespan(app):
    try:
        await startup()
        yield
    finally:
        await shutdown()

无效尝试

常见但无效的做法:

  1. Ignoring the error and restarting the server 70% 失败

    Error will recur if the startup handler still fails.

  2. Removing the lifespan handler entirely 60% 失败

    Removes startup/shutdown functionality, but may hide important initialization.