从 Discuz 迁移到 Xiuno，看起来像是“换个论坛程序”，实际牵涉数据库结构、用户体系、附件路径、URL 规则、插件功能和搜索收录等多个环节。🙂 如果准备不足，最常见的问题不是“迁不过去”，而是迁完以后登录异常、图片丢失、帖子格式错乱、权限混乱、老链接打不开。因此，迁移前一定要先做规划，而不是直接执行转换工具。
一、先确认迁移目标：为什么要从 Discuz 换到 Xiuno？
Discuz 功能完整、生态成熟，但后台和功能模块相对复杂；Xiuno 则以轻量、简洁、运行成本低见长，更适合内容结构不复杂、追求访问速度和维护便利的论坛。迁移前建议先问自己三个问题：是否真的需要保留全部历史数据？是否能接受部分插件功能重做？是否有能力处理迁移后的模板、权限和链接调整？
如果只是想让论坛更快、更清爽，Xiuno 确实是一个可考虑的方向；但如果站点高度依赖 Discuz 的应用中心插件、复杂用户组、门户、积分商城、活动、支付或多端扩展，那么迁移成本会明显增加。迁移不是简单“导入数据”，而是一次论坛架构精简和功能取舍。
二、完整备份是第一优先级 💾
迁移前必须备份三类内容：数据库、附件目录、程序文件。数据库至少包括 Discuz 主库和 UCenter 相关表；附件目录通常包含帖子图片、头像、文件附件等；程序文件则用于回滚、比对路径和查找旧配置。备份完成后，不要只看文件是否存在，还要实际测试能否恢复。
建议在测试服务器上完整还原一次旧站，再进行迁移演练。真正上线迁移时，最好先关闭 Discuz 发帖、注册和评论功能，避免迁移过程中产生新数据，导致最终数据不一致。
三、提前检查 Discuz 数据质量
很多迁移问题并不是 Xiuno 造成的，而是旧 Discuz 数据长期积累后的历史包袱。例如重复邮箱、异常用户名、缺失用户资料、乱码帖子、失效附件、被删除但仍有关联记录的主题等。迁移工具通常只能按规则转换，无法自动判断每一条历史数据是否合理。
公开的 Discuz!X 转 XiunoBBS 工具说明中提到，配置重点包括 database、用户表以及附件迁移等部分，并且针对重复邮箱提供了处理思路，可参考 Discuz!X 转 XiunoBBS 工具说明。因此，正式迁移前建议先统计用户邮箱重复情况、帖子总量、附件数量、版块数量和异常数据，而不是等转换失败后再排查。
四、注意编码、表前缀和数据库版本
Discuz 老站常见问题之一是字符集不统一。有些站点从早期版本升级而来，数据库、数据表、字段、页面输出可能存在 GBK、UTF-8 或混合编码情况。Xiuno 通常更适合统一使用 UTF-8 环境，因此在迁移前要确认 Discuz 数据库字符集、导出文件编码以及目标库编码一致，避免中文标题、用户名、帖子内容出现乱码。
表前缀也不能忽略。Discuz 常见表前缀可能是 pre_，UCenter 可能是 pre_ucenter_，Xiuno 常见表前缀可能是 bbs_。迁移工具配置文件里如果数据库名、账号、密码、端口、表前缀写错，轻则无法连接，重则把数据写入错误的库。配置前建议先在数据库管理工具中逐项核对。
五、用户、密码和登录体验要重点测试 🔐
论坛迁移后，用户能否正常登录是最影响口碑的环节。Discuz 与 Xiuno 的用户表结构、密码处理方式、用户组体系并不完全相同，迁移后可能出现老用户无法登录、管理员权限不完整、用户组映射不准确等情况。尤其是管理员账号，建议至少保留一个新建的 Xiuno 超级管理员账号，避免迁移后后台无法进入。
测试时不要只测管理员账号，还要抽样测试普通会员、版主、禁言用户、邮箱重复用户、长期未登录用户等不同类型账号。对于无法迁移密码或登录异常的情况，要提前准备公告方案，例如引导用户重置密码，避免上线后集中反馈。
六、附件、头像和图片路径不能只看数据库
很多站长以为帖子迁过去就完成了，实际最容易出问题的是附件。Discuz 的附件记录在数据库中，但文件本体在服务器目录里；头像也可能涉及独立目录或 UCenter 关联。迁移时既要转换附件表，也要复制真实文件，并确认访问路径、文件权限和大小写规则。
相关转换工具的项目说明中标注了“附件迁移”能力，但仍需要按配置检查 extension.file 等部分，具体可参考 Gitee 镜像说明。建议迁移后随机打开不同年份、不同版块、不同上传类型的帖子，检查图片是否显示、附件是否可下载、头像是否正常。
七、帖子内容格式要做抽样校验
Discuz 帖子中可能包含 BBCode、表情、隐藏内容、引用、代码块、远程图片、视频标签和插件短代码。Xiuno 对内容格式的支持方式与 Discuz 不完全一致，转换后可能出现标签残留、排版错位、表情失效或隐藏内容变成普通文本。
建议迁移前先列出站内高价值内容，例如置顶帖、教程帖、精华帖、下载帖、公告帖和搜索流量较高的帖子。迁移后优先检查这些页面，因为它们直接影响用户体验和搜索引擎评价。对于无法自动转换的特殊标签，可以考虑批量替换或手工修复重点内容。
八、插件、模板和伪静态规则需要重新评估
Discuz 插件不能直接拿到 Xiuno 使用，模板也不能简单复制。迁移前要列出现有 Discuz 插件清单，区分“必须保留”“可以替代”“可以放弃”三类。比如防灌水、SEO、附件下载、广告位、登录增强、统计代码等功能，都要提前确认 Xiuno 是否有对应插件或是否需要二次开发。
URL 规则也很关键。老 Discuz 页面如果已经被搜索引擎收录，迁移后最好配置 301 跳转，把旧主题链接尽量指向新主题链接。即使不能做到全部一一对应，也要保证首页、版块页、核心帖子页不出现大面积 404。
九、先测试迁移，再安排正式切换 🚧
推荐流程是：搭建测试环境、导入 Discuz 备份、安装全新的 Xiuno、配置转换工具、执行首次迁移、记录错误、修复配置、再次迁移、抽样检查、编写上线方案。公开工具说明也建议先建立 XiunoBBS 4.x 论坛，再配置 config.toml 并执行转换，完成后进入后台更新缓存统计，可参考 工具使用教程整理。
正式上线时，建议选择访问低峰期操作，并准备回滚方案。DNS、Nginx/Apache 配置、PHP 版本、MySQL 权限、目录读写权限、缓存目录、附件目录都要提前确认。上线后不要急着开放全部功能，先观察登录、发帖、回帖、上传、搜索和后台统计是否正常。
总结
Discuz 迁移到 Xiuno，关键不在“有没有工具”，而在“有没有完整的迁移计划”。真正需要注意的是：备份是否可恢复、数据是否干净、编码是否一致、用户是否能登录、附件是否可访问、重要帖子是否正常、插件功能是否有替代方案、旧链接是否尽量保留。
如果你的论坛内容量不大、功能需求简单，迁移到 Xiuno 可以让维护更轻松；如果你的站点依赖大量 Discuz 插件和复杂业务逻辑，就要谨慎评估迁移成本。稳妥的做法是先测试、再修正、后上线，把风险留在测试环境，把稳定交给正式用户。✅
