查找问题与解决方法
Dockerfile ADD 使用 SHA-512 校验时报 digest mismatch
HTTP ADD 的 checksum 只支持 SHA-256。区分算法不支持与同算法内容不符，取得可信预期摘要，保留现有 SHA-512 验证要求。
docker exec 报容器 is paused：命令不会等待解除暂停
paused 容器仍显示 Up，但 exec 会直接失败。先确认暂停是否由备份或维护流程持有，再用 unpause 恢复同一容器，检查进程和业务状态。
PostgreSQL 批量 upsert 报 cannot affect row a second time
PostgreSQL 批量 INSERT ON CONFLICT DO UPDATE 因同批输入重复命中一个键而失败。按完整冲突键检查输入，明确保留规则后去重，并核对批处理边界和重试风险。
Python sqlite3 执行多份脚本后 rollback 没有撤销前面的写入
sqlite3 的 legacy 模式会在 executescript 前提交待处理事务。明确 Python 3.12 之后的 autocommit=False，或在一次完整脚本中显式控制事务，并检查失败后的实际数据。
Docker 挂载含空格路径时报 invalid reference format
未加引号的挂载路径遇到空格，会被 shell 拆成多个参数，让路径片段落到镜像位置。为完整挂载值加双引号，并在测试目录核对实际源路径与只读挂载。
JavaScript 重复调用全局正则 test，同一字符串交替返回 true 和 false
带 g 或 y 的正则会通过 lastIndex 保存匹配位置。独立校验应去掉不需要的状态标志，或在操作开始前明确重置，避免干扰连续提取。
pytest-asyncio 0.25.2 teardown 报 Event loop is closed：检查重复关闭
pytest-asyncio 0.25.2 清理已经被自定义 fixture 关闭的循环时，可能在 teardown 报错。核对 0.25.3 修复边界、循环所有权及新版 event_loop 迁移。
升级 PyTorch 2.6 后，旧检查点报 Weights only load failed
torch.load 从 2.6 起在未指定 pickle_module 时默认受限加载。按检查点内容和可信程度选择 state_dict、精确允许列表或受控旧格式迁移。
git checkout -d 后分支还在，并出现 detached HEAD
执行 git checkout -d 后分支仍在，是因为 -d 在 checkout 中表示分离 HEAD。说明如何保留分离状态下的新提交，核对合并关系，再用 git branch -d 删除本地分支，并保留恢复路径。
PostgreSQL JSON 字段转 text 后带双引号，等值查询返回零行
定位 JSON 表示与业务文本的区别，用 ->> 提取字符串内容，并核对缺失键、JSON null、字段类型和内部转义。
Compass 导出报 Path collision：父对象与子字段不能重复投影
Compass 导出 CSV 报 Path collision 时，先查父对象和子字段是否重复投影。按输出要求整理字段，核对记录范围与类型，不修改集合来试错。
Nginx 已配 TLS，wss 仍失败：前端连到了明文后端端口
wss 地址必须连接实际提供 TLS 的入口。区分浏览器到 Nginx 与代理到应用两段连接，再核对端口、路径、Upgrade 和应用握手结果。
NodePort 改成 Local 后部分节点不通：检查本地端点与负载均衡
externalTrafficPolicy 为 Local 时，全局有后端也不能让无本地端点的节点转发；核对 EndpointSlice 与外部负载均衡检查，并保留源 IP 需求。
BIND 添加 TXT 后报 CNAME and other data：同一名称不能兼作别名
BIND 新增 TXT 后区域无法加载，报 CNAME and other data。对照完整 owner 与验证要求，保留别名业务、区域检查和同步回退条件。
Docker Compose 覆盖网络配置后报 network_mode 与 networks 互斥
覆盖文件新增 networks 不会自动删除基础文件的 network_mode。通过 !reset 清除继承值，核对实际 Compose 版本、文件顺序及切换网络后的通信变化。
Dockerfile COPY 后执行 chmod 报 Operation not permitted
COPY成功后，非root用户执行chmod仍可能因文件默认属于UID0而失败。核对实际USER与属主，通过复制时设置模式或限定安装身份修复，并保留非root运行。
Maven 部分 LangChain4j SNAPSHOT 找不到：BOM 与 beta 模块版本不同
LangChain4j 部分模块与 BOM 不一定使用相同 beta 后缀。遇到 Non-resolvable import POM 时先核对完整坐标和 BOM，再区分仓库策略与本地失败缓存。
OpenSSH 报 no matching host key type found，允许 ssh-rsa 后又要求密码
连接旧 SSH 服务时，客户端先报 no matching host key type found，并列出 Their offer: ssh-rsa；增加 HostKeyAlgorithms +ssh-rsa 后，连接继续了，却没有使用原来的公钥登录，而是要求密码。这两个现象发生在不同认证阶段，不能用同一个选项解释。
Java replaceAll 替换值含美元符号时报 Illegal group reference
Java replaceAll 的替换字符串有捕获组引用和反斜杠转义规则。字面替换值使用 Matcher.quoteReplacement，区分模式引用与替换引用，避免破坏原本需要的捕获组模板。