查找问题与解决方法
Python 直接执行包内文件，相对导入报 no known parent package
用完整模块名启动包内入口，区分没有父包与超出顶层包；核对工作目录和解释器，保留兄弟子包的正确导入关系。
Python 在 finally 中 return，未处理的异常没有传给调用方
Python finally 中的 return 会丢弃待传播异常并覆盖原返回值。把返回放回成功路径，清理留在 finally，明确默认值对应的异常，并核对 CPython 3.14 的编译警告边界。
Nginx 代理启用 SNI 的 HTTPS 后端时返回 502
浏览器直连 HTTPS 后端正常，Nginx 代理却在 TLS 握手时被重置。对照带 SNI 与不带 SNI 的请求，配置正确的上游名称、HTTP Host 和证书验证。
Python 读取 JSONL 报 Unexpected UTF-8 BOM
JSONL 第一行报 Unexpected UTF-8 BOM，给文本行加 decode 又报属性错误。确认文件头后用 utf-8-sig 打开，区分逐行 JSON 与整份文档，并保留字符和记录数量。
SQLite strftime 读取毫秒时间戳返回 NULL
SQLite 日期函数不会从 INTEGER 声明推断毫秒单位。确认原始单位后，在查询中换算成秒并紧跟 unixepoch，核对 UTC 年份、空值与历史数据。
Docker API 内存用量比 docker stats 显示值高
Linux Docker CLI 会扣除特定文件缓存项，API保留原始总量。按客户端版本与 cgroup 对齐公式，保留单位、采样时间和告警阈值边界。
crontab 日期命令报 unexpected EOF
带 date 日期格式的命令在终端正常，放进 crontab 却报 unexpected EOF。未转义的百分号可能让 cron 提前截断命令；逐个转义，或把日期与日志重定向一起移入脚本。
HPA 的 CPU TARGETS 一直 unknown：有使用量，还要有 requests
HPA CPU TARGETS 显示 unknown 时，按 missing request 与指标缺失分开检查，核对实际容器 requests、采集接口及扩缩容行为。
Spring Boot 自定义 Hikari 数据源报 jdbcUrl is required
自定义 Hikari 数据源已有 URL 却报 jdbcUrl is required，沿 Bean 确认绑定对象。区分直接绑定 jdbc-url 与 DataSourceProperties 的 url 转换，保持两层参数前缀一致。
PostgreSQL COPY 导入 CSV 报 Permission denied，文件却能在终端读取
CSV 在终端可读，SQL COPY 仍可能因数据库服务用户无法访问父目录而失败。区分服务端与 psql 客户端读取位置，用客户端导入并在提交前核对数据。
Go 重装后仍报 toolchain not available：检查持久化 GOTOOLCHAIN
Go 重装后仍请求不存在的 go1.22 工具链，可检查用户 GOENV 中持久化的 GOTOOLCHAIN。只撤回错误设置，保留模块要求、其他配置与下载校验。
开机后 apt update 报锁被占用：确认后台更新是否仍在运行
Ubuntu 开机后 apt update 报锁被占用时，核对持有进程、自动更新服务和日志，正常等待或受控恢复，再处理维护窗口与调度，不删除锁文件。
curl 请求含方括号的 URL 时报 bad range
curl 请求中的 filter[name]、args[0] 可能被解析成 URL 范围。保留 shell 引号并使用 --globoff，或编码查询参数中的括号；同时区分参数名与值的编码，以及 -g 和 -G 的作用。
MySQL CREATE TABLE 后 ROLLBACK 没撤销：DDL 已提前提交
MySQL 普通 DDL 会隐式提交此前业务事务，后续 ROLLBACK 无法撤销。区分 InnoDB、atomic DDL 和临时表规则，将结构迁移移出业务事务并核对已提交数据。
Nginx 条件日志报 unknown log format "if=$loggable"
Nginx access_log 把 if=$loggable 当作未知格式时，在条件前补齐日志格式名；再核对 map 完整匹配、默认值和日志作用范围，避免配置通过却过滤错误。
docker ps 按 name=foo 过滤时也选中了 foobar
Docker name 过滤支持部分匹配。已知容器名称时直接检查对象，区分查询失败、对象存在和运行状态，避免把相似名称交给批量操作。
写了 depends_on 仍连不上 PostgreSQL：检查地址、就绪与初始化
区分容器启动、TCP 就绪和初始化完成，解释服务名、健康检查以及官方 PostgreSQL 镜像临时 socket 进程对连接失败的影响。
venv 中 pip 正常，setup.py 子进程却报 No module named pip：检查构建隔离
venv 中 pip 可用，setup.py 内调用子进程却找不到 pip，核对构建隔离，将运行依赖与构建依赖分别声明，避免嵌套安装。
systemd 服务报 200/CHDIR：终端能运行，服务用户却进不了 /root 目录
root 终端可以运行的应用，交给 www-data 服务后报 200/CHDIR。检查工作目录的逐层权限、服务隔离和部署位置，再安全调整启动路径。
Ollama 流式响应让 response.json() 报 Extra data
Ollama 原生聊天默认返回 NDJSON。需要完整结果时设置 stream=false；保留流时逐行解析，检查错误对象及 done，区别 Requests 的 stream 参数。