Retry on fail except for known error Template
工作流概述
这是一个包含19个节点的复杂工作流，主要用于自动化处理各种任务。
工作流源代码
{
"id": "qAzZekQuABuH8uho",
"meta": {
"instanceId": "fb8bc2e315f7f03c97140b30aa454a27bc7883a19000fa1da6e6b571bf56ad6d"
},
"name": "Retry on fail except for known error Template",
"tags": [],
"nodes": [
{
"id": "fa6fb462-8c1b-4cab-a9f6-876e67688786",
"name": "Retry limit reached",
"type": "n8n-nodes-base.stopAndError",
"position": [
-940,
500
],
"parameters": {
"errorMessage": "Retry limit reached"
},
"typeVersion": 1
},
{
"id": "9627165d-1854-4a4f-b840-721f8d779b89",
"name": "Set tries",
"type": "n8n-nodes-base.set",
"position": [
-940,
260
],
"parameters": {
"options": {},
"assignments": {
"assignments": [
{
"id": "cd93a7f6-4c06-4e8a-8d0d-e812c5ec4bc5",
"name": "tries",
"type": "number",
"value": "={{ $json.tries || 0 }}"
}
]
},
"includeOtherFields": true
},
"typeVersion": 3.4
},
{
"id": "466efd16-4922-4e61-bc81-d8e8a1d8ea61",
"name": "Update tries",
"type": "n8n-nodes-base.set",
"position": [
-60,
500
],
"parameters": {
"options": {},
"assignments": {
"assignments": [
{
"id": "df3c9b29-afa6-4e08-868d-5b7e8202eefa",
"name": "tries",
"type": "number",
"value": "={{ $('Set tries').item.json.tries + 1 }}"
}
]
}
},
"typeVersion": 3.4
},
{
"id": "a787761f-0a9d-4834-9a65-ac3b9a65b23e",
"name": "Wait",
"type": "n8n-nodes-base.wait",
"position": [
-280,
500
],
"webhookId": "9d3b561f-4afd-478c-8f6e-60641d4f1d0b",
"parameters": {},
"typeVersion": 1.1
},
{
"id": "ff46ce53-69ca-4f88-8cc9-21b8d1e5557a",
"name": "Catch known error",
"type": "n8n-nodes-base.if",
"position": [
-500,
380
],
"parameters": {
"options": {},
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"id": "6a379b06-0b04-4ae4-9bf9-394bd40744b7",
"operator": {
"type": "string",
"operation": "contains"
},
"leftValue": "={{ $json.error }}",
"rightValue": "could not be found"
}
]
}
},
"typeVersion": 2.2
},
{
"id": "0e9c282a-b521-4549-8ad5-9783b4d614b3",
"name": "Replace Me",
"type": "n8n-nodes-base.noOp",
"onError": "continueErrorOutput",
"position": [
-720,
260
],
"parameters": {},
"typeVersion": 1
},
{
"id": "3b2b6839-65b9-4b0e-8e10-2010014fc8d9",
"name": "Success",
"type": "n8n-nodes-base.noOp",
"position": [
-500,
140
],
"parameters": {},
"typeVersion": 1
},
{
"id": "8d972714-8dcb-4ad6-8b5f-fb30a5f3294f",
"name": "Known Error",
"type": "n8n-nodes-base.noOp",
"position": [
-280,
260
],
"parameters": {},
"typeVersion": 1
},
{
"id": "e98cdc4a-73a4-41d1-bf5e-2a3bcfbf23af",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"position": [
-560,
280
],
"parameters": {
"width": 220,
"height": 240,
"content": "## Set filter
Filter by status code or error message."
},
"typeVersion": 1
},
{
"id": "e5b76cd3-d90a-4d4b-a659-ff142558cbac",
"name": "Sticky Note1",
"type": "n8n-nodes-base.stickyNote",
"position": [
-780,
80
],
"parameters": {
"width": 220,
"height": 320,
"content": "## Replace Node
Replace this by the Node which retrieves the admired data.
Enable error branch in Node Settings and connect the outputs like in this example"
},
"typeVersion": 1
},
{
"id": "7ca409e6-7faf-48d5-972e-abbba3f011ef",
"name": "Sticky Note2",
"type": "n8n-nodes-base.stickyNote",
"position": [
-1220,
420
],
"parameters": {
"width": 220,
"height": 220,
"content": "## Set max tries
Change if needed, default is 3"
},
"typeVersion": 1
},
{
"id": "a13168eb-c4d1-46dd-857b-9a5e13ed1059",
"name": "Manual Trigger",
"type": "n8n-nodes-base.manualTrigger",
"position": [
-1160,
260
],
"parameters": {},
"typeVersion": 1
},
{
"id": "44c17908-96df-471b-97fc-9ce4c3acb3bb",
"name": "Sticky Note3",
"type": "n8n-nodes-base.stickyNote",
"position": [
-340,
400
],
"parameters": {
"width": 220,
"height": 240,
"content": "## Set Wait
Change duration if needed, default is 5s"
},
"typeVersion": 1
},
{
"id": "da7413f0-7962-4cf1-90ad-168cfc3d4c0d",
"name": "Sticky Note4",
"type": "n8n-nodes-base.stickyNote",
"position": [
-560,
80
],
"parameters": {
"color": 7,
"width": 220,
"height": 200,
"content": "Continue here, if the request succeeded"
},
"typeVersion": 1
},
{
"id": "e95c4b6a-2c63-4916-a239-91463728262a",
"name": "Sticky Note5",
"type": "n8n-nodes-base.stickyNote",
"position": [
-340,
200
],
"parameters": {
"color": 7,
"width": 220,
"height": 200,
"content": "Continue here, if the request failed"
},
"typeVersion": 1
},
{
"id": "8d8f7df0-35e3-4b94-96a3-6d4593732d0e",
"name": "Sticky Note6",
"type": "n8n-nodes-base.stickyNote",
"position": [
-1000,
420
],
"parameters": {
"color": 7,
"width": 220,
"height": 220,
"content": "Stop here, if all tries have failed"
},
"typeVersion": 1
},
{
"id": "893b3e51-f30f-4e2f-9e96-e1fc6f8dd0a3",
"name": "Sticky Note7",
"type": "n8n-nodes-base.stickyNote",
"position": [
-1000,
200
],
"parameters": {
"color": 7,
"width": 220,
"height": 220,
"content": "Define counter for tries"
},
"typeVersion": 1
},
{
"id": "cd1b1abb-dbd3-4023-8a6b-49c4ff5510a8",
"name": "If tries left",
"type": "n8n-nodes-base.if",
"position": [
-1160,
500
],
"parameters": {
"options": {},
"conditions": {
"options": {
"version": 2,
"leftValue": "",
"caseSensitive": true,
"typeValidation": "strict"
},
"combinator": "and",
"conditions": [
{
"id": "b18f784a-4386-4ced-a9e1-ce5a21ad036e",
"operator": {
"type": "number",
"operation": "lt"
},
"leftValue": "={{ $json.tries }}",
"rightValue": 3
}
]
}
},
"typeVersion": 2.2
},
{
"id": "ccce734b-c726-4b0a-9d37-7bd6df90e840",
"name": "Sticky Note8",
"type": "n8n-nodes-base.stickyNote",
"position": [
-120,
440
],
"parameters": {
"color": 7,
"width": 220,
"height": 220,
"content": "Update counter for tries"
},
"typeVersion": 1
}
],
"active": false,
"pinData": {},
"settings": {
"executionOrder": "v1"
},
"versionId": "ad610eea-ad27-4a3b-b662-edea474bc5ff",
"connections": {
"Wait": {
"main": [
[
{
"node": "Update tries",
"type": "main",
"index": 0
}
]
]
},
"Set tries": {
"main": [
[
{
"node": "Replace Me",
"type": "main",
"index": 0
}
]
]
},
"Replace Me": {
"main": [
[
{
"node": "Success",
"type": "main",
"index": 0
}
],
[
{
"node": "Catch known error",
"type": "main",
"index": 0
}
]
]
},
"Update tries": {
"main": [
[
{
"node": "If tries left",
"type": "main",
"index": 0
}
]
]
},
"If tries left": {
"main": [
[
{
"node": "Set tries",
"type": "main",
"index": 0
}
],
[
{
"node": "Retry limit reached",
"type": "main",
"index": 0
}
]
]
},
"Manual Trigger": {
"main": [
[
{
"node": "Set tries",
"type": "main",
"index": 0
}
]
]
},
"Catch known error": {
"main": [
[
{
"node": "Known Error",
"type": "main",
"index": 0
}
],
[
{
"node": "Wait",
"type": "main",
"index": 0
}
]
]
}
}
}功能特点
- 自动检测新邮件
- AI智能内容分析
- 自定义分类规则
- 批量处理能力
- 详细的处理日志
技术分析
节点类型及作用
- Stopanderror
- Set
- Wait
- If
- Noop
复杂度评估
配置难度：
维护难度：
扩展性：
实施指南
前置条件
- 有效的Gmail账户
- n8n平台访问权限
- Google API凭证
- AI分类服务订阅
配置步骤
- 在n8n中导入工作流JSON文件
- 配置Gmail节点的认证信息
- 设置AI分类器的API密钥
- 自定义分类规则和标签映射
- 测试工作流执行
- 配置定时触发器（可选）
关键参数
| 参数名称 | 默认值 | 说明 |
|---|---|---|
| maxEmails | 50 | 单次处理的最大邮件数量 |
| confidenceThreshold | 0.8 | 分类置信度阈值 |
| autoLabel | true | 是否自动添加标签 |
最佳实践
优化建议
- 定期更新AI分类模型以提高准确性
- 根据邮件量调整处理批次大小
- 设置合理的分类置信度阈值
- 定期清理过期的分类规则
安全注意事项
- 妥善保管API密钥和认证信息
- 限制工作流的访问权限
- 定期审查处理日志
- 启用双因素认证保护Gmail账户
性能优化
- 使用增量处理减少重复工作
- 缓存频繁访问的数据
- 并行处理多个邮件分类任务
- 监控系统资源使用情况
故障排除
常见问题
邮件未被正确分类
检查AI分类器的置信度阈值设置，适当降低阈值或更新训练数据。
Gmail认证失败
确认Google API凭证有效且具有正确的权限范围，重新进行OAuth授权。
调试技巧
- 启用详细日志记录查看每个步骤的执行情况
- 使用测试邮件验证分类逻辑
- 检查网络连接和API服务状态
- 逐步执行工作流定位问题节点
错误处理
工作流包含以下错误处理机制：
- 网络超时自动重试（最多3次）
- API错误记录和告警
- 处理失败邮件的隔离机制
- 异常情况下的回滚操作