🚑 排错词典
工作流卡住了？把报错原文或现象贴进上面搜索，或直接在下面找。 每条都是：一句话大白话 → 三步排查法 → 怎么修。
共 25 条 · 持续补充中
调用与鉴权
4 条401 Unauthorized401 Unauthorized · 身份没通过验证
服务认识你，但没通过身份验证：Key 没填、填错、过期，或者根本没随请求一起发过去。
403 Forbidden403 Forbidden · 没有权限
身份验证过了，但你没有权限做这件事：Key 的权限范围不够、对应服务没开通，或者调用来源被拒绝。
429 Too Many Requests429 · 你调得太快了
超过了对方的限流额度，服务在说「排队，别挤」。不是坏了，是让你慢点。
404 Not Found404 · 你要的东西不存在
对方那里找不到你要的资源：URL 路径写错、接口版本变了、或者这条数据真的被删了。
数据与格式
4 条Expecting value / JSONDecodeErrorJSON 解析失败 · 喂进来的不是合法 JSON
程序想按 JSON 解析，但拿到的文本不合法：中文引号、少逗号、或者 AI 回答里混了说明文字和代码块标记。
变量取到空值 / undefined变量取到空值 · 上一步根本没产出它
引用了一个不存在的变量：名字打错、上一步没生成它、或者它在另一个作用域里。
Expecting property name enclosed in double quotes中文引号毁掉 JSON · 只认英文双引号
JSON 规范只认英文半角双引号 "，内容里混进了中文的 “ ” 或全角逗号。让 AI 写中文内容时特别容易混。
字段取不到了 / KeyError字段对不上 · 上游数据结构变了
上游改了返回结构（或你换了数据源），下游还按老字段名取值，自然取不到。
触发与连接
4 条Webhook 测试连不上 / 收不到推送Webhook 收不到 · 你没有公网门牌号
对方要把消息推给你，但你的地址公网上找不到——最常见的场景：n8n 跑在自己电脑上，本机没有公网地址。
定时任务没跑 / 时间不对定时任务没跑 · 多半是时区
定时触发器按 UTC 时间在跑，而你想的是北京时间——差 8 小时；也可能任务压根没激活。
飞书机器人发不出消息（权限错误）飞书机器人发不出消息 · 这个员工还没授权
机器人这个「数字员工」没被授权干这件事：没拉进群、没开通消息权限、或收件人 ID 类型用混了。
平台没有我想要的集成节点没有现成集成 · 不代表做不了
自动化平台没提供某个产品的现成插件。只要对方有 API 文档，用 HTTP 请求节点手动接上就行。
模型与内容
4 条context length exceeded / maximum context lengthToken 超限 · 超出工作记忆容量
塞给模型的内容超过了它的工作记忆上限。典型场景：整本文档直接丢进去，或者多轮对话越聊越长。
回答被截断（finish_reason: length）输出被截断 · 长度上限到了
回答生成到一半被掐断——通常是 max_tokens 设小了，或触到了平台输出上限。看 finish_reason 字段：length 就是长度问题。
AI 拒绝回答 / 输出官方套话AI 拒答 · 触发了安全护栏
内容踩到了平台安全线，或请求方式看起来像绕过尝试。它不是不会答，是不被允许答。
同样的提示词，每次输出不一样输出不稳定 · 模型本来就是概率生成
这是正常现象：模型的本质是按概率接下文。但数据处理类业务需要稳定，就得主动去控。
额度与账单
2 条部署与自托管
4 条自动化平台打不开 / 一直超时平台打不开 · 网络路径问题
部分海外服务在国内直连不稳定——不是你配置错了，先分清「平台挂了」还是「网络不通」。
自托管服务重启后，流程全没了自托管数据丢失 · 没做持久化
容器或服务重启后回到出厂状态：你配置的工作流、凭证全丢了——数据没挂载到宿主机，存在容器内部，容器一删就没了。
Error: listen EADDRINUSE: address already in use :3000端口被占用 · 3000 号窗口有人了
你要启动的服务想占 3000 端口，但已经有个程序占着——多半是你上次没关干净的开发服务器。
Vercel 部署构建失败（本地能跑）部署构建失败 · 本地能跑≠线上能建
部署平台要在它的机器上重新执行构建：你本地的缓存、环境变量、Node 版本它都没有。本地 dev 模式宽容放过的错误（类型、缺失变量），构建时严格抓出来。
Git 与构建
3 条CONFLICT (content): Merge conflict in ...合并冲突 · 两个人改了同一行
两条分支改了同一个地方的同一行，Git 不敢替你决定听谁的，把两个版本都摆出来等你裁决。这不是报错，是协作流程的正常一环。
! [rejected] main -> main (non-fast-forward)push 被拒 · 远程有你没有的提交
你要推送的版本和远程对不上：远程收到了你本地没有的新提交（比如你在另一台电脑推过）。Git 拒绝盲目覆盖，先让你同步。
npm ERR! network / npm install 失败npm install 失败 · 网络或源的问题
下载依赖包时网络不通或太慢：默认源在国外，国内网络经常抽风；也可能是代理设置或 Node 版本不匹配。