查找问题与解决方法
SymPy 求平行线段到平面距离，报交点解包 ValueError
SymPy 1.14.0 对平面外的平行线段或射线按单个交点解包。已证明平行时可用端点距离，非平行与符号未定输入不能套用，也不能把原对象换成无限直线。
springdoc 3.0.3 文档报 Null key，检查 HATEOAS 展开模型
springdoc3.0.3配合swagger-core2.2.47时，HATEOAS/Kotlin复杂模型可能在JsonUnwrapped展开中丢失Schema名称。确认文档properties的null键，恢复兼容依赖而非删字段。
Hono 4.12.8 调用 parseBody 后，text() 报 then is not a function
Hono 4.12.8 对非表单请求执行 parseBody 后，普通对象可能进入 Promise 缓存，使下游 text/json 报错。采用含正式修复的版本，并限定表单中间件的解析范围。
pytest setup 或 teardown 报错，tmp_path 却没有保留下来
failed 保留策略的 tmp_path 终结逻辑只看 call 结果。调查期明确保留全部目录，关键诊断产物在清理前独立归档。
setuptools 84 的 Extension 不能放进 set，构建清单怎样改
setuptools 84 的 Extension 改变了相等性与哈希行为，集合或字典清单可能在编译前失败。区分顺序收集与身份去重，避免破坏哈希约定。
.NET 导出的 JSON Schema 拒绝扩展字段，反序列化却能接受
System.Text.Json 的全局 Disallow 与 JsonExtensionData 在 schema 导出时可能不一致。对扩展数据类型显式设置 Skip，保留其他 DTO 的严格规则。
Go 链接时报 R_USEIFACE：检查 TypeFor 与 Comparable 的组合
结构体含多个接口字段时，reflect.TypeFor 后调用 Comparable 可能触发链接器 panic。先按工具链和类型形状定位，再选择语义等价的反射入口。
NumPy 读取 ctypes 继承结构，字段缺失且偏移错位
np.dtype 遍历子类 _fields_ 时可能漏掉父类字段。对已知简单结构显式声明字段、实际偏移与总大小，先验布局再读缓冲区。
Haiku 上 Cargo 启动 rustc 缺 libroot.so：检查 LIBRARY_PATH
RenkuOS 的 Haiku 工具链在未设置 LIBRARY_PATH 的会话中构建，Cargo 添加目录后可能遮住系统默认库路径。核对实际加载器与可信目录，只给所需构建入口补齐环境。
grpc-go 报 header key 包含非法字符，检查直接构造的 metadata.MD
grpc-go 1.84.0 会拒绝直接写进 metadata.MD 的大写头名。Pairs、Set 等入口会规范化名称；修正时保留已有出站元数据、取消与截止时间，不改掉认证值。
attrs 上下文管理器里 super() 报错：检查 slots 重建的类绑定
attrs 的 slots 类在 contextmanager 包装后，零参数 super 可能保留旧类绑定。使用明确的起始类，保留 MRO、资源清理和再次继承的边界。
Bun 1.4.0 旧 canary 第二次导入 SVG 报 Missing 'default' export
旧 Bun 1.4 canary 在入口转译缓存命中后可能把 SVG 等资源误按 TSX 加载；核对冷暖路径、临时关闭缓存和已包含修正的正式 1.4.0。
Celery beat 太阳调度报 ephem.Date 不能与 timedelta 相加
solar 条目遇到当天不存在的太阳事件，可能在日期回退计算中拖垮 beat。隔离故障条目，保留调度历史，避免把类型补丁误当成正确的无事件处理。
xarray 写 NetCDF 报 StringDType 不支持，检查 pandas 3 字符串坐标
pandas 3 的字符串索引可能让旧 xarray 编码器无法写入 NetCDF。明确非空标签类型，核对正式编码修补，并检查失败文件是否丢失坐标。
jOOQ 按第二个嵌套 record 排序，渲染 SQL 就数组越界
MySQL等方言会展开嵌套record投影，ORDER BY序号的重映射可能读错索引。保留排序语义，显式列出实际排序字段，并检查无异常时是否漏了排序列。
SQLAlchemy 关闭连接被取消，旧句柄又弄坏了新连接
异步 close 在连接池重置中被取消时，旧连接对象可能仍指向已归还记录。SQLAlchemy 2.1.6 已补清理；使用上下文管理资源并区分句柄关闭与池中连接复用。
Npgsql 范围参数执行正常，复制日志 SQL 却报 Too many commas
NpgsqlRange 的文本输出受当前文化影响，小数逗号会破坏范围字面量，日期也可能被误读。保留二进制参数化查询，手工诊断时用明确类型构造范围。
JPA 的 @Id @OneToOne 能启动，加上 Repository 却报 does not define an IdClass
实体把 OneToOne 关联直接标成 Id，新增 Repository 后启动失败时，核对父实体主键类型。用标量 ID 与 MapsId 明确共享主键，并同步仓库泛型与保存顺序。
thread-stream 编译报 TS2694，Node 26 类型没有 TransferListItem
thread-stream4.2.0仍使用已从Node26类型中删除的别名。按真实运行时选择类型包，确需26时以可审计声明补丁改为Transferable。
Vite 热更新后懒加载读到另一份单例
Vite 8.3.5 的自接收 HMR 边界可能让父模块保留旧实例，却被后续懒加载以新时间戳再次导入。核对模块 URL，临时停用 HMR 并完整刷新，避免全局变量掩盖双实例。