查找问题与解决方法
Quarkus 3.29.3 的测试在 Docker 24 失效，显式 API 配置要升级后才生效
Quarkus 3.29.3 可能覆盖 Docker API 系统属性，导致 Docker 24 测试失效。采用保留显式配置的修复版本，并在真实测试 JVM 验证容器生命周期。
Prisma 7 提示 @prisma/client 没有 PrismaClient，检查生成目录与导入路径
prisma-client 生成器将客户端输出到自定义目录时，继续从 @prisma/client 导入可能报导出缺失。核对生成路径、adapter、模块格式与镜像产物。
Prisma 7 在 Docker 里报 datasource.url required，先确认配置文件进了镜像
Prisma 7 迁移依赖 prisma.config.ts；镜像遗漏配置时，即使存在 DATABASE_URL 也可能失败。检查最终阶段、配置路径与迁移文件，按部署流程验收。
Docker 升级后 Traefik 报 client version 1.24 is too old，路由不再更新
Docker 服务端与 Traefik 内部客户端 API 不兼容，会阻断服务发现。核对实际 API 范围，升级支持协商的代理，再验证已有及新增路由。
pytest 9 提示自定义参数无法识别，先把文件路径参数改成等号写法
自定义选项的文件路径值可能影响 pytest 初始 conftest 发现。明确测试目录并采用等号参数，核对收集范围和实际参数值。
pytest 跑测试时 iTerm2 不停弹通知，关闭 terminalprogress 就能止住
pytest 的终端进度控制序列可能被 iTerm2 解释为桌面通知。关闭 terminalprogress，并检查 tox、Docker 的配置入口与版本检测边界。
pytest 9.0.0 把 unittest.SkipTest 算成失败，升级后要检查跳过结果
pytest 9.0.0 曾将 unittest.SkipTest 误判为失败。检查实际运行器，采用包含修复的版本，并核对测试报告中的跳过状态与原因。
Next.js 16 用 Bun 构建时找不到 babel-plugin-react-compiler
旧 Bun 的模块解析兼容实现可能漏传搜索路径，让 Next.js 16 Turbopack 找不到已安装的 React Compiler 插件。核对运行时并验证修复后的原构建入口。
Vue 3.5.23 模板明明写对了，却报 Expected ] but found }
Vue 3.5.23 的 TypeScript 模板转换可能丢失右方括号。检查运行时与编译器依赖，采用包含回退修复的版本，并验证构建和绑定行为。
Vite 8 升级后 Emotion 报 init_emotion_react_browser_development_esm 未定义
Vite 8 依赖预构建遗漏跨 chunk 导入，可能让 Emotion 初始化符号未定义。核对版本与缓存，升级包含修复的组合后检查页面、热更新和生产构建。
pandas 3.1 对数组列求 mean 报无法转成 numeric
一列 object 中每格保存 ndarray 时，pandas 3.1.0 的提前数值检查会拒绝数组对象。等长纯数值向量可先 stack 成二维数组，再明确沿行轴求均值。
pandas interval_range 用大整数，却生成了空区间
整数边界接近 2**53 时，interval_range 的浮点中间计算可能合并相邻整数。显式保留整数断点，再构造 IntervalIndex，并检查边界数量和零宽区间。
LangGraph 用 astream 时，SqliteSaver 报不支持 async
同步 saver 不实现异步 checkpoint 方法。使用 AsyncSqliteSaver，并让连接寿命覆盖图执行。
Chroma 报 SQLite 版本太旧，命令行 sqlite3 却已经升级
Chroma 检查 Python 模块绑定的 SQLite。核对服务解释器与动态库，重建运行环境后再测持久化。
升级 PyArrow 21 后，datasets 导入报 PyExtensionType 不存在
旧 datasets 依赖已移除的 Arrow 类型。升级调用方或暂时固定兼容组合，不用类名别名掩盖序列化差异。
Accelerate 拒绝对 device_map="auto" 模型做分布式训练
自动分派用于大模型推理，不能直接叠加 DDP。按训练策略重新加载模型，避免绕过保护。
TrainingArguments 拒绝 evaluation_strategy 参数
4.50.3 仍保留旧字段，4.51.3 已移除。改用 eval_strategy，并核对保存与评估配置。
vLLM 三卡启动报 attention heads 不能被 tensor parallel size 整除
TP 按模型维度切分。检查实际配置和可见 GPU，选择合法并行度，不修改头数伪造模型结构。
加载模型后 .to() 报 Cannot copy out of meta tensor
meta 张量没有权重数据；区分自建骨架与框架 offload，避免用 to_empty 把未初始化权重当成修复。
DDP 第二轮 forward 报上一轮 reduction 还没结束
排查未参与 loss 的可训练参数，再决定启用未使用参数检测或修正训练图。