查找问题与解决方法
Nginx 多个站点重复 include 后报 duplicate upstream
多个 Nginx 站点重复 include 完整 upstream 块，会触发 duplicate upstream。核对加载入口，在 http 中只定义一次后端组，再由各站点引用。
Kubernetes Service 没有可用后端：核对 Pod 标签与 EndpointSlice 就绪状态
Service 端口没错却没有可用后端，先对照实际 Pod 标签与 namespace，再检查 EndpointSlice 就绪条件和目标监听端口。
Go json.Marshal 的 omitempty 没有省略零值结构体字段
encoding/json 的 omitempty 不省略值结构体。用 nil 指针表示缺失，或在 Go 1.24 起使用 omitzero，并核对空对象与缺失键的接口差异。
Secret 已存在仍挂载失败：items.key 要匹配数据键，不是目标文件名
Secret对象存在仍报references non-existent secret key时，区分源数据键与items.path、subPath、应用路径，修正映射并保留凭据轮换条件。
HTTP 验证文件可访问，证书仍失败：检查 CAA 查询的 SERVFAIL
HTTP 挑战文件能返回 200，证书申请仍报 CAA SERVFAIL。比较权威与递归查询，区分无记录、查询错误和 DNSSEC 验证问题。
Protobuf 3.19.1 在 Windows 编译报 C2589：max 宏破坏 std::max
Windows 的 max 宏可能破坏 Protobuf 3.19.1 头文件中的 std::max。核对包含顺序、宏保护补丁及 NOMINMAX 的生效位置。
sudo source 报 command not found，环境变量没有传给后续命令
source 是 Bash 内建命令，sudo 不会自动调用 Shell 解释它。按变量用于当前终端还是提权程序，选择直接加载或在同一次 Bash 调用中加载并启动程序。
Caddy 反向代理报 first record does not look like a TLS handshake
Caddy 返回 502，日志提示 first record does not look like a TLS handshake。核对上游端口的 HTTP 与 HTTPS 协议，修正错误启用的 TLS 传输，并检查重载、负载均衡后端和配置回退。
WebSocket 经 Caddy 从 ws 换成 wss 后失败：检查 Spring 允许的 Origin
HTTP WebSocket 正常、HTTPS 页面连接失败时，核对握手的 Origin 与 Spring 允许来源。区分后端 403、TLS 和代理连接故障，保留认证及消息权限。
Swift 提示 Main actor-isolated initializer：让创建位置与 UI 隔离一致
初始化 UI 模型时报 Main actor-isolated initializer，核对创建方与模型的隔离，通过 MainActor 声明或可等待调用修复，并检查 SwiftUI SDK 和任务时序。
Traefik 后端接入两个 Docker 网络后时通时不通：指定连接网络
应用同时接入代理网和私有网时，Traefik 可能选错后端 IP。对照实际网络，固定 docker.network，并保留数据库和缓存的隔离。
Docker 设置 --cpus=1 后，nproc 仍显示多个处理器
--cpus 限制 CPU 时间配额，--cpuset-cpus 限制可调度的处理器集合。核对 Docker 配置与 nproc 实现，区分 GNU coreutils 9.8 的 cgroup v2 行为。
ssh 测试成功，git push 却 Permission denied：检查主机与密钥配置
用网友 ssh -T 成功但推送失败的案例，比较 github.com 与 ssh.github.com、remote URL、Git SSH 覆盖设置和实际提供的密钥。
JavaScript 数组含有 NaN，indexOf(NaN) 却返回 -1
indexOf 无法按严格相等规则匹配 NaN。需要索引时使用 findIndex 和 Number.isNaN，只判断存在则使用 includes，并避免把 -1 交给删除操作。
Mongoose find 能查到 ID，aggregate 却返回空数组
普通查询按 schema 转换参数，聚合管道不会自动转换。确认存储为 ObjectId 后，在输入边界校验并构造 BSON 值，保留授权条件。
开了梯度检查点，为什么 Transformers 把 use_cache 关了
区分训练时的激活重算与生成时的 KV cache。按模型实现关闭训练缓存，推理前检查生成配置与梯度模式，不把兼容性警告当训练失败。
SwiftUI 父视图更新后 ViewModel 状态归零：检查对象由谁创建
父页面变化后输入或计数归零，检查模型创建位置、StateObject 所有权、视图身份及 iOS 17 Observation 的适用边界。
Docker Compose 环境变量报 contains true, which is an invalid type
Compose 环境变量报 contains true, which is an invalid type 时，检查 environment 映射中的裸布尔值。用引号保留字符串，核验最终配置，并区分类型校验通过与应用开关实际生效。
Docker COPY 无法读取构建上下文外的文件
Dockerfile 使用 COPY ../ 读取父目录文件时，传统构建器会拒绝越界，BuildKit 则会去掉越界路径。按构建上下文调整源路径，并核对 Compose 配置与 .dockerignore。
Gerrit 下载 commit-msg 报 subsystem request failed on channel 0
OpenSSH 9.0 起 scp 默认使用 SFTP，Gerrit 的 SCP hook 下载端点可能拒绝子系统请求。确认失败阶段后限定使用 -O，或改用实例公布的 HTTPS 下载入口。