查找问题与解决方法
kubectl cp 报 tar not found：文件复制需要容器内的归档工具
kubectl cp 明确报 tar not found 时，核对目标容器和镜像工具，按条件选择镜像更新、单文件字节传输或共享卷，并验证文件内容。
Kubernetes ServiceAccount 仍报 cannot list pods：RoleBinding 可能绑错主体
Kubernetes Role 已允许 list pods，ServiceAccount 仍被拒绝时，核对 RoleBinding 主体类型、完整身份和授权空间，避免无依据扩大权限。
Kubernetes Pod 报 unbound immediate PersistentVolumeClaims：先查 PVC 没有绑定的条件
StatefulSet 因 PVC Pending 无法调度，核对实际声明、静态 PV 匹配和供应器；容量只需足够，不要删卷或清理 claimRef 来碰运气。
Docker 拉取镜像报 no space left on device
镜像解压报 no space left on device，但磁盘仍有余量时，检查实际存储文件系统的 inode，定位占用并清理可重建缓存；迁移前区分 Docker 与 containerd 数据目录。
PostgreSQL 布尔列改成 false，CASE 统计结果仍不变
CASE 判断了 true、false 常量却没有引用列，导致条件计数不随数据变化。按列使用 FILTER 或 CASE，并核对空值、空集合及关联后的统计口径。
systemctl unmask 后仍报 Unit is masked：检查实际 unit 文件
systemctl unmask 后仍被屏蔽时，查 unit 的实际路径、空文件或 /dev/null 链接，再区分管理员屏蔽、软件包策略与自建配置损坏。
Android 13 通知不显示也不弹权限框：检查 POST_NOTIFICATIONS 和通知渠道
Android 13 通知不显示时，区分 targetSdk 对弹窗的影响，检查 POST_NOTIFICATIONS、用户选择、升级预授权及通知渠道。
Nginx 连接 TCP 后端报 Permission denied：检查 SELinux 拒绝记录
Nginx 连接 TCP 后端报 connect() failed (13: Permission denied)，用同一次请求的 AVC 记录确认 SELinux，核对策略后调整网络连接权限。
HAProxy 无法加载证书：fullchain.pem 不包含私钥
HAProxy 报 unable to load SSL private key，先确认 fullchain 与匹配私钥的加载方式。保留文件权限、链、候选校验及续期部署流程。
PostgreSQL 备份报 server version mismatch：检查运行 pg_dump 的容器
数据库升级后 pg_dump 仍来自旧备份容器，导致 server version mismatch。核对两端主版本、调用匹配客户端，并让失败退出码、归档检查和隔离恢复成为验收条件。
ext4 的 df 可用空间少于总量减已用：检查保留块
ext4 的 df 总量减已用大于 Available 时，按相同单位比较，读取保留块与块大小，区分普通用户可用空间，调整前保留策略与恢复条件。
MongoDB 查询报 Projection cannot have a mix of inclusion and exclusion
MongoDB find 投影不能混用普通字段的包含和排除。按输出字段约定选择投影模式，核对 _id 例外，避免修复报错时扩大接口返回范围。
Cloudflare 多层子域名报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH：检查边缘证书覆盖
源站已有证书，多层主机名经 Cloudflare 仍握手失败，先核对边缘证书名称范围。区分 Universal SSL 默认覆盖、额外证书能力与临时直连的条件。
SQLAlchemy 捕获 IntegrityError 后仍报会话已回滚：把 flush 和 rollback 放对位置
SQLAlchemy 捕获 IntegrityError 后继续查询仍失败时，先确认错误是否发生在 flush，并对同一 Session 显式 rollback，再开始后续事务。
Certbot webroot 验证返回 404：确认挑战文件对应哪个站点目录
Certbot webroot验证404时，对齐-w与实际站点挑战路径；区分root、location、容器挂载和域名落点，先测试再处理正式签发与续期配置。
PostgreSQL 引用复合主键的部分列，报 no unique constraint matching given keys
PostgreSQL 复合外键必须引用匹配的唯一键。根据业务选择引用完整主键，或为父表添加两列唯一约束，并核对重复数据、空值和迁移锁的影响。
Caddy JSON 配了多个域名却串站：检查 match 数组的 OR 关系
Caddy 原生 JSON 的多域名站点返回同一内容，检查 match 数组的 OR 条件、同集合 AND 关系和 terminal 的位置，再核对实际入口与生效配置。
.gitignore 写了 !.keep，子目录中的文件仍被忽略
.gitignore 的文件例外无法穿过已被忽略的父目录。用 check-ignore 定位规则，先放行目录再保留 .keep，并通过添加预览确认例外范围。