查找问题与解决方法
Docker Compose 2.29.6 报 extra_hosts array items must be unique
Docker Compose 2.29.6 在继承或多文件合并后可能报 extra_hosts 条目不唯一。沿配置来源区分重复声明与版本缺陷，保留必要映射，并在更新插件后核对实际合并结果。
Rust 循环保存字符串引用时报 temporary value dropped while borrowed
Rust 跨循环保存 Option<&str> 时，引用的临时字符串可能提前释放。让 Option<String> 持有游标，在调用处用 as_deref 借用，并保留分页结束与重试语义。
Python 函数里递增外部计数器报 UnboundLocalError
函数里递增外部计数器触发 UnboundLocalError，需区分局部变量、模块状态和闭包状态。按状态归属选择返回值、global 或 nonlocal，并核对条件分支和调用方。
SQLAlchemy 已加 selectinload 仍报 MissingGreenlet：get 可能复用旧对象
AsyncSession 的 get 命中已有对象时可能不执行加载查询，核对 identity map，按业务选择 populate_existing 或显式关系加载，保留未提交状态与版本边界。
PostgreSQL 两表关联时报 operator does not exist: integer = character varying
PostgreSQL 将整数列与 varchar 列关联时需要明确转换方向。根据编号是否保留前导零选择文本或数值比较，并检查脏数据、溢出、重复匹配与执行计划。
MySQL 升级后 DELETE 报 ERROR 1093：多套一层子查询仍可能被合并
MySQL 升级后同表子查询写操作报 1093，检查派生表合并，再按版本选择 NO_MERGE 或受控会话方案，保留候选行与数据恢复要求。
Python 生成器结束时报 RuntimeError: generator raised StopIteration
Python 3.7 起，生成器内部漏出的 StopIteration 会转换成 RuntimeError。用 return 正常结束，并在生成器内处理预期的 next 耗尽，保留普通迭代器协议和真实业务错误。
Kubernetes 私有镜像报 ImagePullBackOff：Secret 必须和实际 Pod 在同一命名空间
私有镜像在其他工作负载能拉取，新 Pod 却 ImagePullBackOff。核对实际 namespace、Secret 引用与遗留同名对象，不把凭据跨空间使用。
LangChain 裁剪历史后，Anthropic 报缺少 tool_result
Agent 第二轮裁剪历史后，工具请求和结果可能失去配对。核对 tool_call_id、完整工具组和实际模型输入，区分 token 计数错误与消息格式错误。
Transformers 批量编码报 tokenizer does not have a padding token
批量编码时缺少 PAD 定义，区分完整 tokenizer 配置、推理中复用 EOS 和新增词表标记；核对 attention mask、模型 embedding 与保存目录。
PostgreSQL 同一事务中多次调用 now()，时间一直不变
PostgreSQL now 和 CURRENT_TIMESTAMP 在同一事务内固定为事务开始时间。按实际时刻或命令开始时间选择 clock_timestamp、statement_timestamp，保留事务边界并验证接收端精度。
Java 整数列表调用 remove(2)，删掉了第三项而不是数值 2
整数参数会匹配按索引删除的重载。使用 Integer.valueOf 明确按值删除，并区分首次匹配、全部重复项和目标不存在的情况。
apply_chat_template 报 chat_template is not set
apply_chat_template 找不到模板时，核对基础模型与对话 checkpoint、本地保存文件及模型角色格式。只用匹配训练格式的模板，避免重复添加特殊标记。
.gitignore 已加入 .env，Git 仍显示文件修改
.gitignore 已写入 .env，Git 仍记录它的修改。用索引和规则检查确认原因，只停止跟踪目标文件，保留本地配置，并检查提交范围、协作影响及撤销方法。
rsync --delete 发布时保留目标独有的 .well-known 目录
rsync 删除目标多余文件时，可用排除规则保留独立目录；若带 delete-excluded，需显式区分接收端保护与发送端隐藏，先预演再执行。
Nginx 在 location 添加响应头后，server 层的响应头消失
Nginx 在 location 新增 add_header 后，上层公共响应头消失。区分 always 与继承规则，使用公共片段，或在 1.29.3 及以后局部启用 merge，并检查重复响应头。
Python isdigit 返回 True，int 转换上标数字却报 ValueError
isdigit 判断 Unicode 数字属性，不能保证文本能解析为整数。按业务语法处理 int 异常或限制 ASCII 字符，并保留输入长度约束。
npm 编译原生模块报 No module named distutils：旧 node-gyp 遇到 Python 3.12
npm 编译原生模块遇到 distutils 缺失时，检查实际 node-gyp 与 Python 路径。Python 3.12 需兼容构建工具，更新被调用的依赖链，保留临时环境与原生 ABI 验收边界。