入门教程教你搭第一个工作流。这篇教你把工作流跑在生产环境——稳定、可复用、出错了能自动告警。
前置条件:
- 已安装 n8n(Docker 或云端均可,参考 n8n 入门教程)
- 有一个可用的 n8n 实例(本地
localhost:5678或云端地址) - 不需要写代码,但需要能看懂 JSON 格式
准备工作:确认 n8n 版本
打开 n8n 界面,点击右上角头像 → Settings → 查看版本号。
n8n 2.0(2026年1月发布)做了重大安全加固,移除了多个遗留的不安全选项。企业生产环境强烈建议使用 2.0+。
一、Webhook:让工作流实时响应外部事件
入门教程里用的是"定时触发"——每隔几分钟跑一次。企业场景更常见的是事件触发:有人提交表单、支付成功、代码推送……这些都需要 Webhook。
创建 Webhook 节点
新建工作流,点击 + 添加节点,搜索 Webhook,配置参数:
- HTTP Method:选
POST(接收外部数据用 POST) - Path:填路径名,如
form-submit - Authentication:选
Header Auth(生产环境必须加认证)
此时你应该看到一个 Webhook URL,格式类似:https://你的域名/webhook/form-submit
测试 Webhook 接收
点击节点上的 Listen for test event,然后发一个 POST 请求:
curl -X POST https://你的域名/webhook/form-submit \
-H "Content-Type: application/json" \
-d '{"name": "张三", "email": "test@example.com"}'
此时你应该看到:n8n 界面显示接收到数据,左侧出现绿色的 Input 数据面板。
测试模式下 Webhook 只监听一次。正式上线前记得点 Activate 激活工作流,否则外部请求不会被处理。
Webhook 收到数据后,连接后续节点
- 发邮件通知:连接 Gmail / Outlook 节点
- 写入数据库:连接 MySQL / Postgres / Airtable 节点
- 触发其他系统:连接 HTTP Request 节点调用第三方 API
二、子工作流:把复杂流程拆成可复用的模块
当一个工作流超过 20 个节点,就该考虑拆分了。子工作流(Sub-workflow)让你把重复逻辑封装成独立模块,主流程调用它就行。
创建子工作流
新建一个工作流,命名为 发送告警邮件,起始节点选 Execute Workflow Trigger(不是 Webhook),添加 Gmail 节点配置邮件模板,保存并记下工作流 ID(URL 里的数字)。
在主工作流中调用子工作流
添加 Execute Workflow 节点,选择 发送告警邮件,配置传入数据:
{
"to": "{{ $json.email }}",
"subject": "新表单提交:{{ $json.name }}",
"body": "收到来自 {{ $json.name }} 的提交"
}
此时你应该看到:主工作流执行时,子工作流被自动调用,邮件发送成功。
同一套发邮件逻辑,可以被 10 个不同的主工作流调用,改一处全部生效。这是企业级工作流和个人工作流最大的区别。
三、错误处理:让工作流不"静默失败"
这是入门教程不会讲、但企业场景最重要的部分。工作流出错了你不知道——这比出错本身更危险。
给单个节点加容错
点击任意节点 → 右上角齿轮图标 → Settings → 开启 Continue on Fail。
开启后,这个节点失败时不会中断整个工作流,而是把错误信息作为数据传给下一个节点。
创建集中式错误告警工作流
新建工作流,命名为 错误告警中心,起始节点选 Error Trigger,连接 Gmail 节点配置告警邮件:
主题:[n8n 告警] 工作流 {{ $json.workflow.name }} 执行失败
正文:
错误时间:{{ $json.execution.startedAt }}
错误节点:{{ $json.execution.lastNodeExecuted }}
错误信息:{{ $json.error.message }}
保存并激活这个工作流。
把其他工作流接入错误告警
打开任意工作流 → Settings(左下角)→ Error Workflow → 选择 错误告警中心。
此时你应该看到:任何工作流出错,你都会收到一封包含详细错误信息的邮件,再也不会静默失败。
发送通知这类"可选步骤"适合开启。核心数据写入步骤不建议开启——失败了应该立刻停止,而不是带着错误继续跑。
四、3 个真实企业场景
效果验证
✅ 完成以上步骤后,你的 n8n 应该能做到
- Webhook 实时接收外部事件,毫秒级响应 ✓
- 子工作流可被多个主流程复用,改一处全部生效 ✓
- 任何工作流出错,自动发邮件告警,不静默失败 ✓
- 三个企业场景可直接套用 ✓