查找问题与解决方法
Trainer 组批报 expected sequence of length，padding 为什么没生效
Trainer 组批时报张量长度不同，检查实际 collator 与输入、标签列。区分分类、token classification、seq2seq 和语言模型的补齐及损失掩码。
Certbot 报 unrecognized arguments --dns-cloudflare-credentials：插件装到了另一套环境
Certbot 不认识 DNS 插件参数时，先检查实际入口是否加载插件。区分系统安装、虚拟环境、旧 certbot-auto 与容器，再安排保留证书状态的安装或迁移。
Arch 用户 locale.conf 不生效：核对会话启动时的 LANG
Arch 用户 locale.conf 修改后桌面语言不变时，区分 locale 生成、当前环境和会话启动加载，核对 LANG 优先级及 xrdp 或显示管理器的实际入口。
vLLM 启动报最大模型长度超过 KV cache 容量
权重已经放进显存，vLLM 仍可能没有足够的 KV cache。核对启动日志中的容量、实际上下文需求和 prefill 配置，再调整模型长度与显存预算。
PostgreSQL 已 GRANT ALL，创建分区仍报 must be owner of table
PostgreSQL 给父表 GRANT ALL 后仍不能创建分区，确认父表 owner 与当前角色，采用维护角色或受控成员关系，并检查分区边界和锁影响。
pandas 链式赋值未生效：用一次 loc 修改父表，区分 Copy-on-Write
pandas 链式赋值未更新原表，按目标选择父表单次 loc 或独立子表 copy，区分 pandas 2.x 的 SettingWithCopyWarning 与 3.0 Copy-on-Write 行为。
Caddy 终端 HTTPS 正常，systemd 启动后证书不可信：核对本地 CA
Caddy 改用 systemd 后内部 HTTPS 不可信，先区分启动权限与客户端校验，再比较数据目录、本地 CA 指纹及客户端信任库。
JavaScript 的 map(parseInt) 把数字字符串转换成 NaN
map 会把数组索引传给 parseInt 的进制参数，导致 NaN 或错误数值。用包装函数固定进制，并区分整数前缀解析与完整输入验证。
Docker Compose 扩容时报 container name is already in use
Docker Compose 扩容遇到固定容器名冲突时，核对合并后的 container_name，移除固定名并按服务操作实例，同时检查端口、数据与缩容回退条件。
Bash 开启 pipefail 后，head 取首行使脚本以 141 退出
下游取首行提前关闭管道，上游继续写入可能收到 SIGPIPE；核对各段状态，有限输入改为完整消费，并保留真实错误与取消边界。
Git 创建分支报 cannot lock ref：已有分支占用了名称前缀
Git 创建 feature/login 时提示 feature 已存在，属于分支名称前缀冲突。用完整引用定位，保留旧分支选择新名字，或通过本地改名释放前缀，并核对提交与回退。
Docker Compose 使用自定义配置后，logs 报 no configuration file provided
Docker Compose 用自定义文件部署后，logs 找不到配置：显式指定原文件路径，区分文件选项与日志跟随选项，并核对项目名及多文件顺序。
HAProxy 主机恢复后长连接仍在 backup：核对连接生命周期与回切条件
HAProxy 首选节点恢复后长连接仍留在备用节点，核对非 backup 的恢复条件、有效权重与新旧连接，评估回切中断和数据服务角色。
curl 下载得到 301 HTML 页面：先检查重定向与最终内容
curl 下载保存了 301 HTML 时，用受控重定向查看最终地址和响应；若跳转本来指向登录或说明页，需找到真实下载入口，再验证文件内容。
SQLAlchemy count 返回 100，all 却只有一个实体
区分关联后的 SQL 行与 Query 按身份去重的实体，将父主键去重放在分页之前，并保留现代 Result 接口和复合主键边界。
systemd 服务写入 /tmp 的文件在终端找不到
应用能读回自己写入 /tmp 的文件，服务器终端却找不到，可能是 systemd 的 PrivateTmp 隔离了临时目录。通过实际进程的目录视图定位文件，再把需要保留的结果迁移到专用状态目录。
PostgreSQL LEAST 提前补大值后，两列 NULL 得到伪数值
LEAST 在 PostgreSQL 中忽略 NULL，全部缺失才返回 NULL。比较前补哨兵值会污染结果，应按业务空值规则调整表达式。
Python sqlite3 executemany 执行 SELECT 报 ProgrammingError
区分批量 DML 与查询结果收集，改用逐项 execute 或绑定参数的 IN 查询，并核对重复项、顺序和空输入。