升级后刷 Invalid type NoneType for attribute 'http.port' value 警告

你会遇到什么

logfire 升级后（案例为 2.11.0 → 2.11.1）控制台大量出现 Invalid type NoneType for attribute 'http.port' value 警告；不配置 logfire 时不出现。你以为是 logfire 的 bug——其实根因不在 logfire，它只是让第三方问题浮出水面。

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

为什么会这样

根因不在 logfire：第三方 HTTP 客户端（案例为某 kiota 系 httpx 适配器）在 url.port 为 None 时仍把 http.port 设置为 None，OpenTelemetry 属性校验对 NoneType 报 warning；logfire 只是把该警告暴露出来（官方 issue #749，closed，维护者定位结论）。

可观测性链路是“生产方 → 校验方 → 展示方”三段：你的应用代码（通过第三方 HTTP 客户端）产生 span 和属性 → OpenTelemetry SDK 按规范校验属性类型 → logfire 把结果展示到控制台。这个警告链路的根因在生产方（第三方客户端传了 None 值），校验方只是按规范报 warning，展示方（logfire）只是把 warning 显示出来。

“升级 logfire 后出现警告”的错觉来自时间巧合：新版本把原本忽略的告警显示出来了，但制造问题的代码一直是第三方。

判断归属有固定方法：看警告在链路哪一段被制造——logfire 侧没有可配置项能消除它（说明它只是展示），第三方修复后警告自动消失（说明根因在第三方）。处理这类“展示层背锅”问题，先定位生产方，别在展示方打补丁。

一步步来

1. 定位设置 http.port 的第三方 HTTP 客户端 — 排查

kiota 系/httpx 适配器类——升级或等待其修复。

2. 确认是第三方问题后，该 warning 无害，可忽略 — 必做

不要在 logfire 侧绕过（无配置项需求）。

怎么确认修好了

第三方修复后警告消失（预期形态）：

升级第三方客户端 → 控制台不再刷 Invalid type NoneType for attribute 'http.port'

或确认根因后忽略：警告无害，不影响功能（官方 issue #749 维护者结论）。

其它环境的表现

症状

logfire 升级后（案例为 2.11.0 → 2.11.1）控制台大量出现 Invalid type NoneType for attribute 'http.port' value 警告；不配置 logfire 时不出现。

原因

根因不在 logfire：第三方 HTTP 客户端（案例为某 kiota 系 httpx 适配器）在 url.port 为 None 时仍把 http.port 设置为 None，OpenTelemetry 属性校验对 NoneType 报 warning；logfire 只是让该警告浮出水面（官方 issue #749，closed，维护者定位结论）。

解法

1. 定位调用链中设置 http.port 的第三方 HTTP 客户端（kiota 系/httpx 适配器类），升级或等待其修复。
2. 确认是第三方问题后，该 warning 无害，可忽略；不要在 logfire 侧绕过（无配置项需求）。