查找问题与解决方法
docker cp 报 lstat no such file：文件在家目录，命令却从根目录运行
docker cp 报本地源文件不存在时，先核对 Docker CLI 的当前目录。区分运行期复制与构建上下文，并检查目标路径、覆盖影响和文件内容。
Nginx 加载证书报 key values mismatch：核对叶证书顺序与私钥
Nginx 更新 HTTPS 证书后报 key values mismatch，按配置实际路径、公钥配对和叶证书顺序区分原因，检查通过后再重载。
Linux umount 报 target is busy：当前终端还在挂载目录里
Linux 卸载报 target is busy，关闭原终端才成功时，检查 shell 工作目录及其他占用。区分普通卸载、lazy 分离和加密映射关闭，保留正常收尾与恢复边界。
Docker 设置 --memory 后，free 仍显示宿主机总内存
区分 free 的系统内存视图与容器 cgroup 限额，检查 Docker 保存的配置和 cgroup v2 控制文件，避免把显示总量当成限制失效。
rsync 报 file has vanished：退出码 24 与动态源文件
rsync 返回 24 并提示 file has vanished 时，确认动态源文件是否属于必须保留的数据；分开保存退出状态与日志，避免过滤管道掩盖其他错误。
SQLAlchemy 内存 SQLite 已建表，请求却报 no such table：连接没有共享
内存 SQLite 已建表但 FastAPI TestClient 请求仍报 no such table 时，检查线程与连接范围；区分串行 StaticPool 和并发共享内存 URI，保留事务与数据生命周期限制。
PyTorch 调了 model.eval()，推理为什么仍占大量显存
eval 控制部分层的训练行为，no_grad 和 inference_mode 控制求导记录。说明纯推理、后续训练和输出留存的不同边界。
pytest 异步 fixture 变成 async_generator：检查 strict 模式和装饰器
async fixture 返回生成器或协程对象时，检查 pytest-asyncio strict 模式与装饰器。区分旧版本症状、新版警告或错误，明确 auto 模式的接管范围及循环生命周期。
JavaScript 对含 BigInt 的对象调用 JSON.stringify 报 TypeError
默认 JSON 序列化遇到 BigInt 会抛出类型异常。用局部 replacer 按接口契约转换成十进制字符串，并在接收方按已知字段恢复，避免转 Number 丢失精度。
pytest 两个目录都有 test_api.py，收集报 import file mismatch
两个测试目录中的同名文件一起收集报 import file mismatch，可选择唯一名称、完整包布局或 pytest 6.0 起的 importlib 模式，并检查辅助导入和实际收集范围。
Docker 单文件挂载后，容器读到的配置没有更新
宿主机保存了配置，Docker 容器仍读到旧内容。单文件绑定挂载遇到文件替换时可能保留旧对象；通过挂载路径、内容摘要和 inode 缩小范围，再选择重建容器或改为专用目录挂载。
Caddy 报 unrecognized directive: dns：先把 tls 放进正确站点块
Caddyfile 转换报 unrecognized directive: dns，先核对站点、tls 与 dns 子块层级，再检查运行构建的提供商模块和证书验证阶段。
systemd 覆盖 ExecStart 后报多条启动命令：drop-in 要先清空旧列表
systemd override 新增 ExecStart 会与原命令累积。用空赋值重置启动列表，检查加载状态并在维护窗口应用与恢复。
同时申请根域和通配符证书：同名挑战可能需要保留两个 TXT 值
Certbot 同时验证根域和通配符时，同名 DNS 挑战可能需要两个 TXT 值。按当前待验证提示保留全部值，核对权威响应及 hook 清理范围。
MySQL UPDATE 返回 0 rows affected，但目标记录确实存在
MySQL UPDATE 默认按实际变化计数，值相同和条件未匹配都可能返回 0。区分 Rows matched 与 Changed，核对 CLIENT_FOUND_ROWS 连接语义，并修正接口的不存在判断。
docker commit 后新容器缺少文件：挂载卷不会打入镜像
容器挂载目录的文件不会随 docker commit 或 export 带走。核对实际卷名，同机重新挂载，跨主机分离备份与镜像，并保留一致性和回退条件。
PostgreSQL 联合 UNIQUE 约束仍允许插入含 NULL 的重复记录
PostgreSQL 默认 UNIQUE 允许含 NULL 的重复组合。核对实际索引定义，在 15 及以上用 NULLS NOT DISTINCT 明确空值唯一性，并先处理已有重复、锁表和回退条件。
SSH 后加 -A 仍没有 agent 转发：连接复用了旧 ControlMaster
启用连接共享后，后续ssh -A仍可能沿用旧master的agent。用-S none建立隔离连接验证，避免终止其他共享会话。
Spring Boot 抛出受检异常后事务没有回滚
受检异常默认不要求 Spring 回滚。检查 rollbackFor、全局回滚规则、异常捕获、代理入口与数据库事务能力，避免只改 throws。