查找问题与解决方法
Docker Compose 报 depends_on 的 required 属性不被允许
旧版 Docker Compose 无法识别 depends_on.required。确认实际插件版本、保留可选依赖和健康条件，避免删掉 required 后又触发 profile 禁用错误。
requests 已安装却报 partially initialized：检查项目里的 http.py
Requests 已安装且交互导入正常，脚本却报 partially initialized 时，核对 http.py 等本地同名文件、导入路径与进程缓存，避免把重装依赖当成通用修复。
Docker 派生镜像新增 ENTRYPOINT 后，入口脚本收不到基础镜像的 CMD
派生 Dockerfile 设置新的 ENTRYPOINT 时，基础镜像的 CMD 会被清空。对照镜像与容器启动字段，在当前镜像中声明默认命令，并保留原入口的初始化要求。
Docker Compose 2.32.1 使用 extends 后丢失 depends_on
Compose 2.32.1 中，服务同时使用 extends 与 depends_on 时，显式依赖可能从最终配置中消失。说明如何核对渲染结果、确认修复版本，并在无法更新时展开继承，保留初始化等待条件。
Python 3 在 Windows 写 CSV，每两条记录之间多出空行
Python 3 CSV 默认行结束符与 Windows 文本换行转换叠加，可能产生额外空行。通过 newline 空字符串修正写入，核对字节与 CSV 记录并保留原文件。
upload-artifact v4 在矩阵任务中报 409 Conflict
矩阵任务共用 artifact 名称会使 upload-artifact v4 上传冲突。按矩阵维度命名，区分串行 overwrite 与并行合并，并检查下载后文件路径冲突。
T4 运行 vLLM 报 Bfloat16 只支持计算能力 8.0 以上的 GPU
vLLM 在 T4 上选择 BF16 后可能启动失败。按 0.6.5 的 dtype 检查区分显卡计算能力与 CUDA 版本，选择受模型和后端支持的精度。
Git 推送时报 src refspec matches more than one：分支与标签同名
本地分支和标签同名时，git push 使用短名称会报 src refspec matches more than one。通过完整引用核对来源，明确推送分支或标签，并验证远程对象，无需先删标签。
Minikube 报 ErrImageNeverPull：宿主机镜像还没进入节点缓存
宿主Docker能运行但Minikube报ErrImageNeverPull时，核对目标profile和节点镜像库，按当前运行时导入明确标签，避免只改拉取策略。
systemd ExecStart 写了管道和 tee，日志文件却没有创建
ExecStart 直接写 | tee 不会启动 shell 管道。根据日志去向改用 journal 或有版本条件的 append 输出，核对用户服务范围、权限、覆盖文件和重启后的记录。
sudo -u postgres psql 报 command not found，切换用户登录后却能运行
sudo切换postgres身份找不到psql，检查secure_path与客户端完整路径，避免用sudo echo判断或取消全局路径策略。
SQLite printf 加同名别名后，整数排序变成文本顺序
ORDER BY 优先匹配输出别名，printf 返回文本。明确按输入数值列排序，保留显示字段名，并核对存储类型、并列顺序与查询层次。
MySQL 导入报 ERROR 1153：客户端与服务端的包大小都要检查
导入大 BLOB 或多行 INSERT 时，仅改 mysql 客户端上限可能无效。检查服务端、连接继承值和备份语句，再评估临时调整与恢复重试。
Prisma 查询能用，迁移报 prepared statement s0 already exists：分开池化与直连地址
Prisma 业务查询正常，迁移通过 PgBouncer 报 prepared statement s0 already exists 时，分开 CLI 直连与运行时池化地址，核对 Prisma 版本及失败迁移状态。
Python re 报 look-behind requires fixed-width pattern
Python 后行断言把开头锚点与字母并列时，分支宽度不同会导致编译失败。将选择移到断言外，或用捕获组提取可变前缀后的内容，并检查匹配位置。
Poetry 当前 Python 能运行，version solving 却失败：看声明的支持范围
Poetry 按项目声明的 Python 范围求解，而不只看当前解释器。根据真实兼容范围修改约束，区分发行元数据与锁定范围，避免用条件依赖跳过必需功能。
PostgreSQL 替换视图报 cannot change name of view column
PostgreSQL 的 CREATE OR REPLACE VIEW 要求已有列保持名称、顺序和类型。列改名可使用 ALTER VIEW RENAME COLUMN，并同步调用方与迁移定义，避免为改名删除依赖视图。
BIND 修改 MX 后仍收不到邮件：缺少尾点让域名重复拼接
BIND zone中的MX owner或目标缺少尾点，会被ORIGIN重复扩展。核对绝对名称、权威响应及SOA版本，再分别验收缓存与邮件投递。