查找问题与解决方法
Nginx gRPC 报 too large http2 frame,检查 Fabio 的监听协议
gRPC 请求返回502和 too large http2 frame,核对 Nginx 下一跳与 Fabio 的监听端口、协议及RPC路由。
pnpm 10 跳过 isolated-vm 构建,启动找不到 out/isolated_vm
安装跳过isolated-vm脚本,启动又缺少原生文件;分开检查pnpm10许可、构建工具链及最终镜像产物。
Node.js fetch 报 ETIMEDOUT,检查地址族的单次连接等待时间
fetch 的 AggregateError 同时含 ETIMEDOUT 与 ENETUNREACH,先比较重定向与网络路径,再核对单次地址连接等待。
Node.js 导入 JSON 报 ERR_IMPORT_ATTRIBUTE_MISSING,检查 type 属性
ESM 读取 package.json 报缺少 JSON 类型属性,检查实际产物、with 语法版本与 createRequire 路径。
Node.js require 遇到顶层 await 报错
升级 Node 后插件启动报 ERR_REQUIRE_ASYNC_MODULE,核对顶层 await、旧加载器捕获码和异步调用链。
JS 请求返回 text/html,先查 Nginx 实际送回了哪个文件
JS 地址收到首页 HTML,先沿多层代理查真实 URI 和文件,再区分静态资源失败与 SPA 页面回退,保留正确 MIME 和 API 路由。
Next.js 16 本地 Strapi 图片报 resolved to private ip
Strapi 图片可直连,Next 16 优化器却在本地 IP 检查时拒绝。核对真实日志、容器网络与受控开发配置,区分生产私网需求。
SQLAlchemy 2.1.6 两组 loader criteria 互相引用,编译时报递归错误
SQLAlchemy 2.1.6 中,两个实体的 loader criteria 经关系互相引用,仍可能在编译时无限递归。保留数据隔离条件,核对正式修复与临时兼容边界。
Next.js 多实例偶发 Failed to find Server Action,先核对构建产物
多实例表单偶发 Server Action 失效?核对完整构建产物、清单、构建时密钥和旧标签页的版本关系,保留提交幂等边界。
Nuxt typecheck 在 shared 上下文找不到 computed,检查 app.config 的类型引用
Nuxt 类型检查把 app 配置导入链拉进 shared 环境时,可能误报 computed 或 useNuxtApp 未定义。核对 4.5.1 的声明隔离及配置键 unknown 边界。
AnyIO TaskGroup 包装 TimeoutError,外层 except TimeoutError 为什么没接到
AnyIO 4 会把单个普通异常也包装成异常组。展开叶子,用 except* 选择性处理超时,保留清理失败与调用方取消的边界。
ProcessPoolExecutor 报 BrokenProcessPool,先找 Exception in initializer
BrokenProcessPool 前有 initializer 异常?先检查 worker 实际模型路径与加载结果,补齐资源后关闭失效池,并按完成状态重建任务。
uv workspace 依赖能解析,运行仍找不到本地包
workspace 依赖能解析,不代表成员已打包安装。检查成员构建系统、package 设置、同步参数,以及目标解释器实际导入位置。
pip 构建 wheel 时 hg 找不到标准库,普通 shell 却能运行
pip wheel 内 hg 连标准库也导入不了?核对 .pth 启动错误和子进程 PYTHONPATH,选择局部环境处理或有条件的隔离方式。
asyncio.wait 报 Passing coroutines is forbidden,先检查传入对象
Python 3.11 起 asyncio.wait 不接受裸协程。正确创建并持有 Task,处理 done、pending 与取消,核对第三方库已发布修复。
QueueHandler 与 multiprocessing 共用同一队列,首次写日志就卡住
首次日志触发队列初始化,内部 DEBUG 又回送同一队列,可能死锁或递归。检查 QueueHandler 路径、日志配置和正常退出。
Pydantic 2.7 的 serialize_as_any=True 误报 circular reference
递归字段以 None 结束,运行时 duck typing 却报循环引用?核对 Pydantic 2.7 历史误报、包含修复的依赖组合和子类输出契约。


