> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/changelog/migration-report.md).

# 用迁移报告检查 Duaer 能否升级

在 Duaer 里，迁移报告会扫描所有数字组织和实例配置，列出升级到下一个主版本之前要处理的问题。
## 打开迁移报告

Duaer 实例的所有者或管理员在「设置 → 迁移报告」打开。顶部一句话写着有多少个数字组织已经兼容目标版本，例如「你的 40 个数字组织中已有 36 个与版本 3.0.0 兼容」。目标是让剩下的数字组织和实例配置都没有问题。

每一项变更的说明见 [Duaer v3 破坏性变更](/zh/changelog/v30-breaking-changes.md)。

## 看懂 Duaer 迁移报告的问题

问题分在两个标签页：「数字组织问题」列出影响具体数字组织的变更，「实例问题」列出影响整个实例的配置。每个问题都有标题、说明、文档链接和严重程度：

- Critical：升级后会坏。数字组织要改或替换受影响的节点；实例问题可能让实例起不来。
- Medium：可能还能跑，但结果可能不对。升级前检查并测试。
- Low：个别情况下行为略有变化，大多数数字组织照常工作。

## 处理数字组织问题

1. 从 Critical 开始，点问题下方的「N 个数字组织」，打开受影响的数字组织列表。
2. 列表显示名称、是否已发布、受影响的节点、执行次数、上次执行和上次更新时间。点受影响的节点会直接打开那个节点。
3. 按问题的文档链接修改数字组织，先在测试环境里跑一遍。
4. 有的问题带「迁移」按钮，可以一键改好。迁移把改动存成新版本，已发布的版本照常运行；确认无误后点「发布」上线，或点「跳过发布」稍后再发。

## 处理实例问题并复查

实例问题要改环境变量或部署方式，按每个问题的文档链接处理。都改完后点「刷新」重新扫描，直到两个标签页都显示没有问题，再按 [更新 Duaer](/zh/hosting/installation/updating.md) 升级。
## Questions

### 谁能看到 Duaer 的迁移报告？

Duaer 实例的所有者和管理员。普通成员在设置里看不到这一项。

### Duaer 迁移报告里的「迁移」会马上改动线上吗？

不会。在 Duaer 里，迁移只把改动存成新版本，已发布的版本照常运行，要再点「发布」才上线。