常见报错排查手册

npm / node 命令被拦截

现象

CODEBUDDY_BROKER_DENY
Brokered host mkdir requires an available runtime file rule
Sensitive content approval timed out

根因 环境变量 NODE_OPTIONS 被注入了拦截脚本，脚本挂在 node 进程上，不是沙箱层的问题。

解法

env -u NODE_OPTIONS npm install
env -u NODE_OPTIONS npm run build

注意：dangerouslyDisableSandbox 对这个无效——问题出在 node 进程，不在沙箱。跟用哪个 node 版本也无关，只认这个环境变量。

MCP 服务连不上

现象：Not connected

排查顺序

1. 配置文件名对不对（mcp.json 不是 .mcp.json）
2. JSON 格式对不对
3. 连接器管理页有没有点「信任」——写完配置不会自动生效
4. command / args 是不是照抄官方文档（猜的字段基本跑不通）

还不行就换方案：某些 MCP 服务稳定度一般，本地驱动更可靠。比如浏览器自动化，直接用本地 Playwright + 指定本机 Chromium 路径，比 MCP 版稳得多。

沙箱环境访问不了某些域名

现象

fetch failed / 连接 10 秒超时

部分境外域名在沙箱环境里完全不通（Google 系、部分存档站尤其常见）。

解法 不要反复重试——重试十次也是一样的结果。让对方把内容复制粘贴过来，或者下载成 txt 放进工作区。

构建成功但页面是旧的

现象：重新构建后浏览器里还是旧内容，站内搜索也搜不到新页面。

根因 浏览器标签页缓存了旧页面，而搜索索引文件名带内容哈希，旧页面还在找已不存在的索引文件。

解法：强制刷新 Cmd + Shift + R，或者关掉标签页重开。

文件写入失败 / 权限被拒

排查

1. 目标目录有没有授权给工作区
2. 是不是在系统目录（/System、/Library、AppData）
3. macOS 首次写入的授权弹窗有没有点允许

定时任务不执行或结果不对

排查

1. 脚本是不是需要交互输入（会卡死）
2. 日志有没有落文件（不落日志等于没法排查）
3. 工作目录对不对（相对路径在定时任务里容易找错文件）
4. 抓取是不是静默失败（源站改版导致选择器失效，抓到空结果）

中文乱码

场景：导出的 CSV 用 Excel 打开乱码

解法：导出时用 UTF-8-BOM 编码。纯 UTF-8 在 Excel 里会乱码。

长会话开始答非所问

根因：上下文积累太多无关信息，AI 抓不住重点。

解法：开新会话，把关键信息重新喂一遍。重要的结论先存进项目记忆，跨会话能复用。

通用排查方法论

遇到没见过的报错，按这个顺序：

1. 完整粘贴报错，不要概括（堆栈里有行号和调用链）
2. 问根因，不只问解法——“为什么会报这个错”通常比“怎么修”更有价值
3. 最小化复现：能不能用三行代码复现？能的话问题范围就锁定了
4. 确认是不是环境问题：换个目录跑、换台机器跑，排除环境干扰

下一篇

与其他 AI 工具协作——多模型分工策略。