查找问题与解决方法
Dockerfile 中多行 shell heredoc 报 unknown instruction
Dockerfile 先解析指令，shell 引号不会把多行配置归入同一个 RUN。使用 BuildKit 的 COPY 或 RUN heredoc，或把静态文件放进构建上下文。
Rust 在 for 循环前调用 collect，编译报 cannot infer type
collect 需要确定目标集合类型，类型标注不会自动消除元素引用。直接遍历 keys，或明确收集为 Vec，并按键类型处理单层与双层引用。
Compose 卷名后加子目录报 undefined volume
命名卷短语法不会把斜杠后的内容当作子目录。核对 Engine 与 Compose 版本，使用 volume.subpath，并在挂载前准备目录、验证卷身份和数据位置。
HAProxy 扩容后新节点流量很少：会话 Cookie 仍绑定旧节点
HAProxy健康扩容后流量仍偏向旧节点时，区分新请求分配与Cookie持久化，评估maxidle、maxlife以及迁移对应用会话的影响。
Python 离开 except 后读取异常变量报 NameError
Python 3 会在 except 结束时清除 as 后面的目标名字，同名初值也不会恢复。将临时别名与业务变量分开，按需保存错误文本或异常引用，并覆盖无异常路径。
LaunchedEffect 仍调用旧回调：区分 effect key 和 rememberUpdatedState
LaunchedEffect 等待结束后调用旧回调时，区分任务需要重启与回调需要更新，用 rememberUpdatedState 在执行时读取最新值，并核对 key 的业务含义。
Compose 2.19 的 run --no-deps 仍报依赖 disabled：核对构建分支回归
Compose 2.19 的一次性任务即使使用 --no-deps，构建分支仍可能报依赖 disabled。核对插件版本、真实 profiles 与 2.20.0 已包含的处理顺序修复。
PostgreSQL 同事能建表，自己报 read-only：检查 HA 写入入口
PostgreSQL HA 中一台客户端能建表、另一台却只读时，对照原连接的恢复状态与地址，核对硬编码 IP 和写入入口，区分备用节点与普通只读事务。
awk -v 传入路径后反斜杠消失或变成换行
Shell 引号无法取消 awk 命令行赋值的转义解析。对需要原样保留的路径或标签，通过环境变量和 ENVIRON 传递，并区分后续正则或命令语法。
PostgreSQL 容器报 could not resize shared memory segment
PostgreSQL 容器执行查询或维护时报共享内存无法扩展。核对容器内 /dev/shm、POSIX 内存实现和故障时用量，调整 Compose shm_size，保留镜像与数据挂载，并重建容器验证原操作。
SQLite 本地有表，部署后却报 no such table：核对实际数据库路径
SQLite 本地能查、部署后报 no such table 时，在失败连接核对完整数据库路径，区分 Django 配置和独立 sqlite3 连接，防止相对路径隐式创建空库。
Git 本地分支是 master，推送 main 报 src refspec main does not match any
首次提交已经在 master 上生成，推送 main 却找不到来源引用。核对本地分支与 HEAD，按项目约定改名或使用正确名称推送，再确认远程提交和上游关系。
Docker 串口报 Permission denied：检查设备 GID 与进程附加组
串口已映射但应用 Permission denied，核对设备数字 GID、业务进程附加组和入口身份，通过最小 group-add 与设备映射处理，保留隔离与硬件验收限制。
SQLAlchemy 更新 JSONB 后未传字段丢失：UPDATE 不会自动深度合并
局部请求被当成整个 JSONB 值保存时，区分整列替换、路径更新与浅层连接，并为应用读改写保留行锁或版本冲突处理。
PostgreSQL UNION 后按表别名排序报 missing FROM-clause entry
UNION 后的排序引用合并输出，分支表别名不在该范围。用输出列名或外层关系排序，并保留去重、分页和返回列的原有含义。