---
title: "N8nWorkflowStandard"
type: concept
tags: []
last_updated: 2026-04-25
---

# N8nWorkflowStandard（n8n 工作流标准）

## Definition
n8n 编排的生产级工作流必须遵循的 10 步标准结构，确保每个自动化链路具备完整的可靠性、可审计性和可恢复能力。

## Ten-Step Structure

1. **Trigger**（触发器）：工作流的启动条件（定时/Webhook/API/事件）
2. **Input Validation**（输入验证）：校验触发数据格式和必填字段
3. **Data Normalization**（数据规范化）：统一字段格式、类型转换
4. **Business Logic**（业务逻辑）：核心处理步骤
5. **External Actions**（外部操作）：对外部系统的写操作（API 调用、数据库写入）
6. **Result Validation**（结果验证）：确认外部操作返回符合预期
7. **Logging / Audit Trail**（日志/审计跟踪）：记录完整执行轨迹
8. **Error Branch**（错误分支）：异常处理的专门路径
9. **Fallback / Manual Recovery**（降级/人工恢复）：无法自动恢复时的兜底方案
10. **Completion / Status Writeback**（完成/状态回写）：更新任务状态并通知相关方

## Naming Convention
```
[ENV]-[SYSTEM]-[PROCESS]-[ACTION]-v[MAJOR.MINOR]
```
示例：`PROD-CRM-LeadIntake-CreateRecord-v1.0`

规则：
- Major version：破坏性逻辑变更
- Minor version：向后兼容改进
- 禁止模糊命名（"final"/"new test"/"fix2"）

## Related Concepts
- [[ReliabilityBaseline]]：每个工作流必须包含的可靠性组件
- [[AutomationGovernance]]：治理框架决定哪些工作流值得实施
- [[IntegrationGovernance]]：外部系统集成的治理规范

## Sources
- [[automation-governance-architect]]（primary）