QuartTrio集成Sentry.io启动崩溃，求解决方法

问题描述 #

基于QuartTrio官方示例编写的最简应用，使用hypercorn -k trio quarttriosentry:app运行正常，但添加Sentry SDK后程序启动崩溃。

正常运行的代码 #

from quart_trio import QuartTrio

app = QuartTrio(__name__)

@app.route('/')
async def hello():
    return 'Hello World'

添加Sentry后的崩溃复现步骤 #

1. 安装SDK：pip install --upgrade sentry-sdk
2. 修改代码如下：

from quart_trio import QuartTrio
import sentry_sdk

sentry_sdk.init(
    dsn="https://<removed>@<removed>.ingest.de.sentry.io/<removed>",
    enable_tracing=True,
)

app = QuartTrio(__name__)

@app.route('/')
async def hello():
    return 'Hello World'

错误信息 #

> hypercorn -k trio quarttriosentry:app
Process SpawnProcess-1:
  + Exception Group Traceback (most recent call last):
  |   File "/usr/lib/python3.10/multiprocessing/process.py", line 314, in _bootstrap
  |     self.run()
  |   File "/usr/lib/python3.10/multiprocessing/process.py", line 108, in run
  |     self._target(*self._args, **self._kwargs)
  |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/hypercorn/trio/run.py", line 127, in trio_worker
  |     trio.run(partial(worker_serve, app, config, sockets=sockets, shutdown_trigger=shutdown_trigger))
  |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/trio/_core/_run.py", line 2288, in run
  |     raise runner.main_task_outcome.error
  |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/hypercorn/trio/run.py", line 46, in worker_serve
  |     async with trio.open_nursery() as lifespan_nursery:
  |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/trio/_core/_run.py", line 954, in __aexit__
  |     raise combined_error_from_nursery
  | exceptiongroup.ExceptionGroup: Exceptions from Trio nursery (1 sub-exception)
  +-+---------------- 1 ----------------
    | Traceback (most recent call last):
    |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/hypercorn/trio/run.py", line 48, in worker_serve
    |     await lifespan.wait_for_startup()
    |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/hypercorn/trio/lifespan.py", line 66, in wait_for_startup
    |     await self.app_send_channel.send({"type": "lifespan.startup"})
    |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/trio/_channel.py", line 194, in send
    |     self.send_nowait(value)
    |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/trio/_core/_ki.py", line 181, in wrapper
    |     return fn(*args, **kwargs)
    |   File "/home/jtuckey/.pyenv/versions/quarttriosentry/lib/python3.10/site-packages/trio/_channel.py", line 172, in send_nowait
    |     raise trio.ClosedResourceError
    | trio.ClosedResourceError
    +------------------------------------

解决方法 #

1. 安装带Quart集成的Sentry SDK #

执行命令安装包含Quart适配的SDK版本：

pip install sentry-sdk[quart]

2. 调整初始化逻辑与顺序 #

修改代码，先创建QuartTrio实例，再初始化Sentry并指定Quart集成，确保Sentry正确适配QuartTrio的异步生命周期：

from quart_trio import QuartTrio
import sentry_sdk
from sentry_sdk.integrations.quart import QuartIntegration

# 先创建QuartTrio应用实例
app = QuartTrio(__name__)

# 初始化Sentry，传入Quart集成
sentry_sdk.init(
    dsn="https://<removed>@<removed>.ingest.de.sentry.io/<removed>",
    enable_tracing=True,
    integrations=[
        QuartIntegration(app)
    ]
)

@app.route('/')
async def hello():
    return 'Hello World'

3. 可选：禁用冲突的默认集成 #

如果仍有问题，可禁用Sentry的默认集成，仅保留Quart和必要的异步相关集成，避免与Trio模型冲突：

sentry_sdk.init(
    dsn="https://<removed>@<removed>.ingest.de.sentry.io/<removed>",
    enable_tracing=True,
    integrations=[
        QuartIntegration(app)
    ],
    default_integrations=False
)

原因分析 #

原代码中Sentry初始化在QuartTrio实例创建之前，且未指定Quart专用集成，导致Sentry的默认钩子错误拦截了QuartTrio的生命周期事件（如启动阶段的通道通信），触发trio.ClosedResourceError。调整初始化顺序并添加Quart集成后，Sentry能正确适配QuartTrio的异步运行模型，避免生命周期冲突。

内容的提问来源于stack exchange，提问作者Jay Tuckey