查找问题与解决方法
pnpm 安装发布包报 WORKSPACE_PKG_NOT_FOUND：检查包内未转换的 workspace 协议
pnpm 安装发布包报工作区依赖缺失时，区分本地成员遗漏与包内残留 workspace 协议，核对打包后的清单和外部消费结果。
Git 已设置 safe.directory，后续命令仍报 dubious ownership
checkout 成功，后续 Git 命令仍报 dubious ownership 时，在失败步骤中核对用户、HOME、仓库路径和配置来源，只为确认可信的目录添加例外。
Vite 开发时缺少 default 导出：链接的 CommonJS 包没有进入预构建
链接的 CommonJS 包在 Vite 开发模式中缺少 default 导出时，核对实际入口、显式预构建和缓存，并单独验收正式构建。
Docker Compose 环境变量含 ${Time.now} 时报 Invalid interpolation format
Compose 把应用需要的 ${Time.now} 当成变量表达式时，使用双美元符号保留原文，并区分 YAML、环境文件和 shell 的解析阶段，验证容器收到的值。
Linux Docker 容器无法解析 host.docker.internal
Linux Docker 容器访问 host.docker.internal 提示无法解析。为现有 Compose 服务添加 host-gateway 映射，重建后分别验证容器 hosts、系统解析与宿主机服务连接，并处理监听地址不匹配。
cron 报 command not found，终端却能执行：先区分 PATH 与任务隔离环境
cron 中找不到终端可用命令时，检查任务自己的 PATH、账户及解释器；绝对路径仍不存在时，继续检查面板隔离文件系统。
Webpack 报 ERR_OSSL_EVP_UNSUPPORTED：检查 OpenSSL 与 loader 哈希链
Webpack 在 OpenSSL 3 环境报哈希算法不支持，沿堆栈核对 Webpack 与 loader，区分 xxhash64 配置范围、依赖升级和临时 legacy provider。
Certbot HTTP-01 验证收到其他站点的内容
Certbot 验证文件返回另一个网站的 HTML，IPv4 访问却正常。比较有效挑战在 IPv4、IPv6 上的响应，核对 AAAA 和 Nginx 监听及虚拟主机，并用 staging 续期确认修复。
Docker Git 上下文构建报 /.git not found
Git 上下文默认不保留 .git，忽略规则例外不能恢复它。用预定义参数保留构建所需仓库信息，或明确选择路径上下文，并限制最终产物。
curl 指定 IP 并设置 Host 后，HTTPS 仍提示证书名不匹配
HTTPS 请求 URL 使用 IP 时，修改 Host 不能改变证书验证名称；保留业务域名，用 --resolve 指定源站连接地址。
Docker 登录成功，push 仍 denied：检查镜像是否带 Docker Hub namespace
登录成功只证明认证完成。推送目标若落到 docker.io/library，应为本地镜像添加有写入权限的 namespace 标签。
Git fetch 后仍看不到其他远程分支
单分支克隆后，git fetch --all 仍可能只更新原分支。确认远端目标分支存在，检查 remote.origin.fetch，并按需追加一个分支或恢复全部普通分支的抓取范围。
Docker Compose 写了两个 command，初始化命令没有执行
Docker Compose 同一服务重复写 command 不能按顺序执行初始化和主程序。说明单个 command 配合 sh -c、初始化失败阻断、ENTRYPOINT 参数冲突，以及重建后的验证和数据回退边界。
PostgreSQL 用 array_length 等于 0 查不到空数组
PostgreSQL 空数组的 array_length 返回 NULL，等于 0 的条件因此漏选。改用 cardinality 判断元素数量，并区分空数组、NULL 数组和含 NULL 元素的数组。
Go 给 map 中结构体的切片字段赋值时报 cannot assign to struct field
Go 的 map 元素为结构体值时，不能直接给其字段赋值。取出整个结构体修改后写回，或在明确引用语义后改用指针，同时检查缺失键和 make 容量提示导致的初始化遗漏。
HAProxy CPU 很低却连接超时：检查每秒连接上限 maxconnrate
HAProxy 资源占用很低仍连接超时，核对 maxconnrate 接入速率限制与实际 Runtime API 指标，按容量有范围调整，不用请求数代替连接速率。
curl 发送 POST 时报 Could not resolve proxy: POST
curl 命令误写 -x POST 会把 POST 当成代理名。区分代理与请求方法参数，保留正常网络配置，并用表单上传示例核对修复后的请求。
Podman rootless 发布低端口报 permission denied：检查 Linux VM 的权限阈值
Podman rootless 发布低端口报 permission denied 时，核对实际 Linux 或 machine VM 的端口阈值，按客户端能力改高端口，或由管理员评估绑定策略。
kubectl apply 大型 CRD 报 annotations Too long：处理客户端配置注解
大型 CRD apply 报 annotations Too long 时，区分 schema 与客户端生成的配置注解，评估服务端 apply、字段管理冲突和现有资源恢复边界。
SQLAlchemy 设置 expire_on_commit=False 仍报 DetachedInstanceError：会话已关闭
SQLAlchemy 返回 ORM 对象后读取属性报错时，核对 sessionmaker 会话范围、已加载数据与序列化边界；关闭会话不受 expire_on_commit=False 阻止。