查找问题与解决方法
MongoDB 连接串报 Password contains unescaped characters：只编码凭据部分
MongoDB URI 密码含特殊字符导致解析失败，分别编码原始用户名和密码，检查重复编码，区分解析、认证与网络故障。
xargs 删除已有文件却报 No such file：转义引号成了文件名的一部分
xargs 处理带空格文件名时，转义双引号被当作路径字符，导致已有文件仍找不到。区分 shell 引用与参数内容，用 NUL 分隔并保留删除恢复条件。
APT 更新 Docker 软件源时报 Signed-By 冲突
APT 更新 Docker 软件源时报 Signed-By 冲突。定位同一仓库的重复 .list 与 .sources 条目，备份后只停用确认多余的配置，保留签名验证，并核对索引更新、软件包来源和回退路径。
pip 提示 externally-managed-environment：本机与 GitHub Actions 分别处理
解释系统 Python 的 EXTERNALLY-MANAGED 标记，本机按项目选择 venv，GitHub Actions 显式配置 setup-python，避免盲目绕过保护。
Python timedelta.seconds 计算超过一天的时长时少了整天
seconds 只是归一化分量，负时长也可能给出正数。使用 total_seconds 或直接比较 timedelta，保留天、微秒和符号，核对浮点精度与输入时区语义。
Room 报迁移路径缺失：已写 Migration 仍失败，先检查实际 Builder
Room 提示迁移路径缺失，检查真正使用的数据库 Builder、版本路径和 schema 一致性，通过迁移测试保留旧记录，避免以删库或破坏性回退掩盖升级问题。
HTTPS 用 IP 访问仍报 COMMON_NAME_INVALID：SAN 必须是 IP 类型
CA 已信任，用 IP 打开 HTTPS 仍报 COMMON_NAME_INVALID，检查 SAN 的 IP 类型、实际入口证书和重签成品，保留链与私钥保护。
Alembic 建索引报 cannot run inside a transaction block
Alembic 迁移中并发建索引被 PostgreSQL 事务块限制拒绝时，用 autocommit_block 划分执行区段，并核对提前提交、失败遗留无效索引及降级边界。
HikariCP 长任务后 MySQL 通信失败：连接已借出却长时间没有 SQL
区分池内空闲和任务持有连接；核对会话与网络超时，避免用 maxLifetime 或自动重连掩盖事务边界问题。
训练越跑越占显存，running_loss += loss 会留下什么
区分日志累加、待反传损失与 retain_graph；用数值保存训练日志，并按相同步骤观察已分配显存，避免把缓存或优化器状态误判为泄漏。
npm 全局安装 EACCES：检查 prefix、权限与 PATH
遇到 /usr/local/lib/node_modules 权限错误，先确认 node/npm、prefix 与失败目录，再采用版本管理器或用户目录并核对 PATH。
Redis 写入报 READONLY：先确认节点角色和主写入端点
读请求正常而写入落到只读副本时，核对 ROLE、应用连接池与 Sentinel 主节点发现；不以关闭只读保护或盲目提升副本处理。
Kubernetes drain 被 PDB 阻止：单副本与零中断预算无法自动腾出节点
kubectl drain 因单副本与零中断预算反复被拒绝时，核对 PDB 状态与就绪副本，选择受支持的冗余或停机流程，保留健康与不健康 Pod 的驱逐区别。
scp 在两台不同 SSH 端口的远程主机之间复制时连错端口
远端到远端复制需要分别表达两端的 SSH 端口。使用独立 Host 配置和本地 -3 中转，核对有效端口，并区分连接、认证与 SFTP 子系统故障。
Nginx 配置检查报 server_names_hash_bucket_size: 64
Nginx 报 server_names_hash_bucket_size: 64 时，64 是当前值。针对较长域名导致的桶容量不足，在正确的 http 上下文中调整数值，并区分 max_size 提示、配置检查和重载结果。
nc -uz 显示 succeeded，但 UDP 服务仍然不可用
OpenBSD netcat 的 UDP 零扫描成功提示不能证明远端服务可用。改用合法协议请求和响应核验；DNS 场景用 dig 区分 UDP 回应、错误状态与完整解析。
Docker Compose 修改环境变量后，restart 仍使用旧值
Docker Compose 修改 environment 或 env_file 后，restart 不会更新已有容器的环境。区分最终配置、容器环境与应用行为，再重建指定服务，并核对数据保留和回退条件。
asyncpg 改表后报查询计划失效
在线修改 PostgreSQL 结构后，旧连接的查询计划或类型缓存可能失效。区分事务内外处理、直接 asyncpg 与 SQLAlchemy 的缓存参数，并安排迁移和连接生命周期。
curl 发送文件后换行丢失，Content-Length 小于文件大小
curl 使用 --data @文件 时会去掉回车、换行和空字节。保留请求体原始内容应使用 --data-binary，并核对媒体类型、原始字节及接口处理结果。