n8n v2.0 迁移工具#
迁移工具可帮助你为将 n8n 实例升级到 2.0 版本做好准备：它会识别在升级前需要处理的工作流与配置项。
你可以在此页面查看 v2 的全部 breaking changes。
访问工具#
前往 Settings 设置 > Migration Report 迁移报告 查看你的兼容性状态。
User role access 用户角色权限
迁移工具仅对全局管理员可用。
理解迁移状态#
在页面顶部，你会看到：
「X out of Y workflows are compatible with n8n 2.0」
这会告诉你升级后有多少工作流无需更改即可继续运行。你的目标是解决那些阻碍其余工作流兼容的问题，同时也要处理实例级（全局）的兼容性问题。
查看问题#
工具会将潜在问题分为两类：
Workflow Issues Tab 工作流问题标签页#
显示会影响实例中某些特定工作流的 breaking changes。
每个问题会显示：
- Issue title 问题标题： 问题的清晰命名
- Severity badge 严重程度标识（Critical/Medium/Low）： 修复紧急程度
- Critical： 必须在升级前修复，否则工作流会失败
- Medium： 可能导致非预期行为，或需要尽快关注
- Low： 较小的变更或弃用，不会破坏功能
- Description 描述： 说明变更内容，以及为何重要
- Documentation link 文档链接： 点击阅读更详细的迁移说明
- Affected workflow count 受影响工作流数量： 有多少工作流存在该问题
Workflow Issue Detail Page 工作流问题详情页#
点击 X workflows affected 受影响的工作流数量 查看所有受影响的工作流。
每个工作流会显示：
- Name 名称： 工作流名称。点击名称可打开工作流编辑器。
- State 状态： 工作流是否已发布
- Node affected 受影响节点： 受该问题影响的所有工作流节点列表。你可以点击某个节点，打开工作流编辑器并定位到该节点视图。
- Number of executions 执行次数： 工作流的总执行次数
- Last executed 最后执行： 工作流上次执行日期
- Last updated 最后更新： 工作流上次更新日期
Instance Issues Tab 实例问题标签页#
显示会影响整个 n8n 实例（而不是特定工作流）的配置变更。
每个问题会显示：
- 与工作流问题相同的信息（标题、严重程度、描述、文档）
- No workflow count 无工作流数量： 这些是适用于整个实例的全局设置
v2.0 迁移工具会扫描你的 n8n 实例，识别升级到 v2.0 所需处理的潜在兼容性问题与配置变更。本参考文档会说明工具执行的每项检查、解释检测到的问题影响，并提供迁移准备建议。
理解空状态（Empty states）#
No Workflow Issues Found 未发现工作流问题#
所有工作流都与 v2.0 兼容。请查看 Instance Issues 实例问题 标签页，确保服务器配置也已就绪。
No Instance Issues Found 未发现实例问题#
你的实例配置与 v2.0 兼容。请查看 Workflow Issues 工作流问题 标签页，确保所有工作流也已就绪。
Both Tabs Empty 两个标签页都为空#
你的 n8n 实例已经完全准备好升级到 2.0 版本。
推荐处理流程#
Initial Assessment 初始评估#
- 查看兼容性摘要
- 浏览两个标签页中的所有问题，了解影响范围
Sort by Severity 按严重程度排序#
- 先从 Critical 问题开始（它们会导致工作流中断）
- 再处理 Medium 问题（可能导致问题）
- 最后处理 Low 问题（弃用警告）
Fix Workflow Issues 修复工作流问题#
- 点进每个问题，查看受影响的工作流
- 阅读文档中的修复说明
- 按需更新每个工作流
- 在开发环境中测试工作流
Address Instance Issues 处理实例问题#
- 更新环境变量或服务器配置
- 按文档逐项处理每个实例级变更
Verify Your Work 验证你的工作#
- 点击 Refresh 刷新 重新扫描。如果看不到 Refresh 刷新 按钮，直接刷新页面即可重新扫描。
- 确认不再存在未解决的问题
- 验证兼容数量与工作流总数一致
Proceed with Upgrade 开始升级#
处理完所有问题后，你就可以升级到 n8n 2.0 了。