查找问题与解决方法
Nginx 容器反向代理出现 502：localhost 指向了哪里
宿主机能访问后端，Nginx 容器却返回 502？结合网友的 Nextcloud 案例，区分宿主机与容器 localhost，核对内部端口和共同网络。
通配符证书带根域后 CAA 拒绝：核对 issue 和 issuewild
通配符订单同时包含根域时，issuewild 允许与 issue 禁止可能导致 CAA 拒绝。对照订单名称、实际权威记录及授权策略再调整。
VS Code 无法运行 Activate.ps1：先区分 PowerShell 策略与 Python 环境
VS Code 的 Activate.ps1 被 PowerShell 策略阻止，直接检查环境解释器，按终端与组策略选择激活方式，临时设置可恢复。
Certbot 续期无法绑定 80 端口：检查 standalone 验证与现有服务
Certbot 续期仍使用 standalone，与 Nginx 占用 80 冲突。核对证书验证器、监听者及 hooks，按版本保存新续期配置。
psycopg2 写 JSONB 报 can’t adapt type dict：显式选择 JSON 适配
JSONB 列不会替 psycopg2 自动适配 dict。用局部 Json 包装保留参数绑定，区分重复序列化、读写注册、JSON null 与 SQL NULL，并核对全局 hstore 冲突。
Nginx 配置 http2 on 后报 unknown directive "http2"
独立 http2 指令从 Nginx 1.25.1 开始提供。核对实际运行版本和 HTTP/2 模块，按旧版兼容语法或升级后的配置处理，并在重载前验证。
Bash 脚本给 UID 赋值时报 readonly variable
Bash 的 UID 是只读用户 ID 变量。导入脚本应把业务账户字段改成独立变量名，同步修改引用，并检查实际执行入口。
CronJob 固定晚八小时：Pod 的 TZ 不会改变控制器调度时区
CronJob 稳定偏差八小时，Pod 的 TZ 无法改变控制器计划。核对 Job 计划时间，Kubernetes 1.27 起在 spec.timeZone 指定时区，保留旧集群与夏令时边界。
网页能打开，Docker 却一直 unhealthy：从检查输出找原因
读取 Health.Log 的退出码与输出，按工具缺失、端口、HTTP 响应、变量展开和超时排查，避免用关闭检查掩盖问题。
ts-node ESM 找不到相对模块：导入应写输出文件的 .js 扩展名
ts-node 已加载 ESM 入口却找不到相对模块时，核对显式扩展名、Node 模块解析与源文件映射；开发运行和编译产物分别验证。
curl 加上 --path-as-is 后仍未发送 URL 的 #fragment
curl 的 URL 片段不会进入正常 HTTP 请求。区分 path-as-is 的路径归并控制、%23 数据编码，以及本机测试中 request-target 的原始目标覆盖。
Docker exec 使用通配符时报 No such file or directory
Docker exec 用星号列文件时报 No such file or directory，但进入容器后正常。区分宿主机与容器的通配符展开，用 sh -c 处理，并检查无匹配项、隐藏文件和引用范围。
Nginx 正则含 {2} 后无法启动：pcre_compile failed missing )
Nginx location 正则带量词时参数被配置解析截断，先为整个表达式加引号，再核对实际匹配范围。
Docker COPY 找不到同目录文件：build 的标准输入只有 Dockerfile
把 Dockerfile 文本重定向给 docker build - 时，没有文件系统上下文。区分上下文参数与 -f -，让 COPY 能读取项目目录。
Caddy 设置 auto_https off 后仍无法通过 HTTP 访问
auto_https off 关闭证书自动化与跳转，不改变站点地址推断的 HTTPS 协议。本地 HTTP 服务须明确协议、监听地址和请求 Host。
find 批量复制报 are the same file：搜索结果包含了目标目录
GNU find 搜索树包含复制目标目录时，cp 会把目标文件再次复制到自身。先预览范围并剪枝，再处理同名覆盖、路径形式与命令退出状态。
/etc/hosts 已有映射，host 查询却返回另一个地址
hosts 中的本机映射不等于 DNS 数据。使用 glibc getent 检查系统解析路径，区分 BIND host 查询、NSS 来源顺序和应用实际运行环境。
PostgreSQL identity 列插入 NULL 报 violates not-null constraint
PostgreSQL identity 列显式插入 NULL 不会触发自动编号。通过省略列或 DEFAULT 修正 SQL，并为 JDBC 自动编号与指定编号分别绑定参数。
StatefulSet 设置 restartPolicy: Never 被拒绝：一次性任务需要另选控制器
StatefulSet 拒绝 Never 时，区分长期服务与一次性任务，按 Job 完成和重试规则调整控制器，并保留存储迁移与业务去重条件。