FastAPI+SQLModel 测试报 sqlalchemy.exc.NoInspectionAvailable

你会遇到什么

简单 FastAPI + SQLModel 应用，加了 logfire.instrument_pydantic 后用 TestClient 测试，报 sqlalchemy.exc.NoInspectionAvailable: No inspection system is available for object of type ...；去掉该行则正常。

你会以为 logfire 坏了——其实是老版本 logfire 与 SQLModel 的已知冲突，早已修复。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

logfire 的 Pydantic 插桩会检查模型对象，与 SQLModel 的 SQLAlchemy 检查路径冲突（SQLModel 自身已知问题，fastapi/sqlmodel#71）；logfire 2.11.0 及更早版本触发，2024-12-30 于 2.11.1 修复（官方 issue #728，closed）。

“插桩（instrumentation）”是在第三方库里挂钩子：logfire 的 Pydantic 插桩会拦截模型对象的创建/校验，往里面注入观测逻辑。

冲突的根源是两条检查路径撞车：SQLModel 的模型同时是 Pydantic 模型和 SQLAlchemy 模型，logfire 按 Pydantic 路径检查它，SQLModel 底层却走 SQLAlchemy 的检查路径（inspection system），两边对同一个对象各查各的、机制互不兼容，旧版 logfire 触发时就炸出 NoInspectionAvailable。

这是依赖版本组合问题（logfire × SQLModel 的特定版本交叉），不是代码写错——“去掉 instrument_pydantic 就正常”恰恰证明你的业务代码没问题。

处理这类问题的确定性路径固定：先查“这个报错是不是已知问题”（issue 搜索，官方修复版本号）→ 升级到修复版本 → 用最小用例复测（本市场就是这么验证的：按 issue 描述写最小用例，4.41.0 下 HTTP 200 无报错）。

版本组合类问题，升级优于改代码。

一步步来

1. 升级 logfire — 必做

pip install -U logfire

国内加 -i https://pypi.tuna.tsinghua.edu.cn/simple。

2. 仍出现时：确认插桩调用位置 — 必做

instrument_pydantic 与 instrument_fastapi(app) 的调用位置要对（4.41.0 的 FastAPI 插桩必须在 app 创建后传参调用，且需先装 logfire[fastapi] extra）。

怎么确认修好了

最小用例运行正常（实测输出形态）：

FastAPI + SQLModel + TestClient + instrument_pydantic + instrument_fastapi
→ HTTP 200，无 NoInspectionAvailable（logfire 4.41.0 实测）

其它环境的表现

症状

简单 FastAPI + SQLModel 应用，加了 logfire.instrument_pydantic 后用 TestClient 测试，报 sqlalchemy.exc.NoInspectionAvailable: No inspection system is available for object of type ...；去掉该行则正常。

原因

logfire 的 Pydantic 插桩会检查模型对象，与 SQLModel 的 SQLAlchemy 检查路径冲突（SQLModel 自身已知问题，fastapi/sqlmodel#71）；logfire 2.11.0 及更早版本触发，2024-12-30 于 2.11.1 修复（官方 issue #728，closed）。

解法

1. 升级 logfire 到 >=2.11.1（本市场收录 4.41.0 已包含修复）：pip install -U logfire（国内加 -i https://pypi.tuna.tsinghua.edu.cn/simple）。
2. 仍出现时：确认 instrument_pydantic 与 instrument_fastapi(app) 的调用位置（4.41.0 的 FastAPI 插桩必须在 app 创建后传参调用，且需先装 logfire[fastapi] extra）。