查找问题与解决方法
Transformers 开启 FlashAttention 2 后报包不可用
按错误分支区分缺包、版本和设备要求；支持时用 SDPA 或 eager 建立可运行基线。
Llama 3.1 加载时报 rope_scaling 必须只有两个字段
旧 Transformers 校验器不认识 Llama 3.1 的 RoPE 配置。核对实际解释器，再升级兼容版本，保留模型原始配置。
Black 局部格式化后全文件 check 误报通过，避免写入完整缓存
Black 局部格式化错误写入完整文件缓存时会使全文件检查误通过，应采用缓存写入修复并连续验证两种入口。
Svelte 的 select 后加文本就编译失败：静态 value 生成了错误 AST
Svelte 5.56.3 的 select 带静态 value 且后有兄弟节点时，可能在 esrap 输出阶段报 null.type。核对 5.57.0 修复并保留表单语义。
Go 程序启动就报内核版本解析失败，检查 uname 的厂商后缀
Go 程序在 main 之前报内核版本解析失败，可能是 uname 的厂商后缀未被旧解析器接受。1.27.2 包含解析处理，应重建并核对设备实际运行的二进制。
Micronaut 代理启动报重复 toString，核对惰性代理的生成方法
Micronaut 惰性代理重复生成 toString 可使 class 加载失败。Core 5.2.15 包含生成条件修补，更新处理器后须重编译代理并验证原有方法行为。
Node 能解析 ## 别名，Vite 却报 Missing "#" specifier
包内 imports 的名称含第二个井号时，Vite 可能把后半段当成 URL fragment。统一改为单井号命名时要同时调整映射与导入。
Axum OptionalQuery 遇到尾部问号，空参数也报 missing field
axum-extra 0.12.6 把尾部问号解析为 Some 空字符串，必填字段因此返回 400。只将真正空 query 规范为 None，非法字段仍按原规则拒绝。
FastAPI 挂载 MCP 后首个请求 500，漏掉的是宿主 lifespan
FastAPI 挂载 MCP 子应用时，宿主 lifespan 需要管理 session manager。合并原有生命周期，并通过 initialize、list_tools 和工具调用验证，健康检查 200 不够。
fmt 放进自定义命名空间后模板报错：先恢复受支持的集成方式
GCC 11 与 fmt 12 的自定义命名空间集成出现 formatter 歧义或找不到内部符号时，先撤回 FMT_BEGIN_NAMESPACE 注入，不采用未经确认的库内模板补丁。
Black 去掉文件开头空行后文字乱码，保留原编码声明的位置
Black 移动原本被忽略的编码声明时会改变文件下次解码，应采用保留空行修复并核对格式化后的字符值。
setuptools-scm 构建无标签归档时，报 tag '' 和 AssertionError
归档有提交哈希却没有describe-name，旧解析器可能把空值当标签。核对隔离构建的实际后端，修复后仍需检查wheel版本与真实发行身份。
MCP 本地正常，部署后一直 421 Invalid Host header
MCP 返回 421 Invalid Host header 时，核对代理转发后的实际 Host 和 SDK 白名单。按目标版本分别配置 Host 与 Origin，并验证获准主机能初始化、未知主机仍被拒绝。
Native 镜像请求 Elasticsearch HTTPS 报 setEnableRetransmissions 反射缺失
GraalVM native 镜像访问 Elasticsearch HTTPS 时缺少 setEnableRetransmissions 反射调用提示，限定 HttpCore 分支补充 RuntimeHints 后重建验证。
pytest -c 指向不存在的文件，为什么换后缀就开始跑测试
pytest 9.1.1 对不存在的 -c 配置路径按后缀表现不同，可能直接运行空配置测试。启动前验证必需文件，并核对实际配置及测试选择。
Windows PyPy 的 CFFI 扩展编译成功却无法导入，检查文件后缀
Windows PyPy 下 CFFI 扩展已编译却无法导入，setuptools 84.2 的稳定 ABI 后缀选择可能丢失 PyPy 标记。比较实际后缀，再约束真正的构建环境。
Requests 加文件上传后报 int 没有 translate，检查字段名
Requests 的表单没有文件时能准备，添加 files 后却报整数没有 translate。检查两组字段名，按接收端契约提供字符串，保留重复字段和冲突检查。
Rich Text 设置居中仍靠左，给 Console.print 明确传 justify
Rich Text 自身设置居中，作为 Console.print 顶层参数时仍靠左。显式传递输出对齐方式，检查合并文本的属性边界和实际区域。
CA2264 自动修复后报 CS0501：箭头方法不能只留分号
SDK 10.0.402 的 CA2264 修复可删除整段表达式方法体，留下不合法的分号声明。对非可空 int 的无效 ThrowIfNull 检查，人工保留合法空块并审查 diff，不改变原方法签名。
JaVers 7.11.5 比较嵌套 List 报 ClassCastException
JaVers7.11.5在AS_SET的快照哈希路径把List当Set转换。7.11.6正式版改用Collection接收这两类集合，修正时保留列表顺序、重复项与审计契约，不强改领域集合。