查找问题与解决方法
Python 比较时间报 can't compare offset-naive and offset-aware datetimes
带偏移的时间与 datetime.now() 比较时报 TypeError，使用 aware UTC 当前时间，区分 astimezone 转换和 replace 标记，避免无声改变时间含义。
Jupyter 调用 asyncio.run 报 running event loop：在单元格中等待协程
Jupyter 单元格已有事件循环时，使用顶层 await 等待异步函数。区分普通脚本入口、autoawait 配置和库内部同步入口，保留异常与结果传递。
Job 一直 ImagePullBackOff 不结束：backoffLimit 不限制拉取次数
Job 等待错误镜像时，拉取事件不计作容器运行失败，backoffLimit 无法限制总等待。区分 Pod 与 Job 两层期限，并核对 DeadlineExceeded 和终止影响。
Android 12 创建 PendingIntent 崩溃：正确选择 FLAG_IMMUTABLE 与 FLAG_MUTABLE
普通通知、直接回复和依赖库分别检查 PendingIntent 创建点，按功能选择不可变或可变标记，并处理 targetSdk 34 的目的地限制。
Docker apt-get 安装报 404：分开的 update 层可能复用了旧索引
Docker 构建的 apt-get 安装返回软件包 404，检查 update 是否命中旧缓存。合并更新和安装，区分基础镜像刷新及软件源错误。
Maven 报 release version 21 not supported：实际 JDK 与项目要求不符
Maven 版本检查通过后仍不支持 release 21，应核对当前 POM 与实际编译 JDK，区分 Maven 运行环境、toolchain 和 CI 镜像。
git checkout -- * 因未跟踪文件报 pathspec 错误
git checkout -- * 报未跟踪文件的 pathspec 错误时，先核对 shell 展开和索引状态，再用明确路径恢复。说明暂存区与 HEAD 的区别及覆盖前的备份要求。
FAISS 的 IndexFlatIP 为什么会返回大于 1 的分数
IndexFlatIP 返回内积。需要余弦相似度时，库向量与查询向量都要归一化，检查 float32、零向量及原地修改行为，区分 L2 与近似索引。
cert-manager 经 RFC2136 更新 DNS 报 REFUSED：先看 BIND 拒绝的是哪个区域
cert-manager 更新 DNS 报 REFUSED、TSIG 却有效时，核对实际区域、CNAME 委托和 BIND 授权。保留主区域保护，按准确目标限定 TXT 更新权限。
Kubernetes ServiceAccount 显示 0 Secrets：旧的取令牌命令不再适用
Kubernetes 1.24 起新建账户不再默认生成长期 token Secret。区分旧字段命令、TokenRequest 与 Pod 投射令牌，核对身份、期限与实际访问。
Python 列表调用 sort 后，接收结果的变量变成 None
Python list.sort 原地修改列表并返回 None，空列表也不例外。按是否需要修改输入选择单独调用 sort 或返回 sorted 新列表，核对别名、空输入与恢复原顺序的边界。
safetensors 报 HeaderTooLarge，下载到的可能只是 LFS 指针
HeaderTooLarge 不等于权重模型太大。检查实际文件前缀、大小与哈希，识别 Git LFS 指针和错误页，再按原格式补全文件。
Git 克隆后目录为空，提示 remote HEAD refers to nonexistent ref
Git 对象已下载却没有检出文件时，核对远端 HEAD 与实际分支。恢复本地跟踪分支，并区分指定分支克隆、本地 origin/HEAD 和服务端默认分支修复。
Starlette TestClient 升级 HTTPX 后报 unexpected keyword argument app
HTTPX 0.28 删除 app 参数后，旧 Starlette TestClient 可能在构造阶段失败。核对实际测试环境、框架约束与锁文件，再验证 lifespan 和原测试。
Windows 的 DataLoader 一加 num_workers 就报 bootstrapping phase
num_workers=0 正常、开启多进程后失败时，检查 spawn 导入入口、main 保护及顶层 Dataset 定义；不要只压掉 worker 异常。
MySQL 临时表自连接报 ERROR 1137：换别名仍引用同一张表
MySQL 临时表自连接报 1137 时，识别同一张 TEMPORARY 表的重复引用，按版本与结果使用范围选择 CTE 或独立临时副本。
Java 把 int[] 传给 Arrays.asList 后列表只有一个元素
int[] 会作为一个数组元素进入 Arrays.asList，不能自动逐项装箱。用准确泛型确认结构，再显式转换为整数列表。
pyodbc 报 Login failed for user 空用户名：先检查 UID/PWD 属性
pyodbc 在证书错误之后报空用户名登录失败，核对 ODBC UID/PWD 属性、SQL 登录与 TLS 验证，避免把不同阶段的问题混在一起。
systemd timer 只执行一次：oneshot 服务仍是 active (exited)
systemd 定时器只执行一次且服务保持 active (exited) 时，检查 RemainAfterExit；一次任务应结束为 inactive，带 ExecStop 的服务须先核对生命周期。
Redis 连接报 NOAUTH 或 WRONGPASS
Redis 客户端报 NOAUTH 或 WRONGPASS 时，检查认证参数、实际加载的配置与 ACL 用户状态；若认证通过后出现 NOPERM，再核对命令和键权限。