如何升级WildFly服务器？从30.x版本升级至35版本并保留配置

一、升级前准备 #

• 全量备份现有WildFly实例：包含standalone/domain目录下的所有配置文件、已部署应用包、自定义模块（若有），以及数据库连接相关的敏感配置文件
• 确认应用兼容性：核对应用依赖的Jakarta EE API版本（WildFly 30基于Jakarta EE 9.1，35基于Jakarta EE 10），检查代码中是否存在过时API调用，提前调整兼容
• 准备新版本安装包：获取WildFly 35.x的官方压缩包，解压到与旧实例独立的新目录（禁止覆盖原有实例文件）

二、自动化配置迁移（核心步骤） #

利用WildFly内置CLI工具完成配置自动迁移，确保原有配置完整保留并适配新版本：

1. 停止运行中的WildFly 30.x实例
2. 进入新WildFly 35.x的bin目录
3. 执行对应模式的迁移命令：
   • 独立模式：

     ./jboss-cli.sh --command="migrate standalone --source=旧实例standalone目录路径 --target=新实例standalone目录路径 --backup"
     

   • 域模式：

     ./jboss-cli.sh --command="migrate domain --source=旧实例domain目录路径 --target=新实例domain目录路径 --backup"
     

   该命令会自动迁移standalone.xml/domain.xml、用户认证配置等文件，自动更新过时配置元素，并生成备份文件用于回滚

三、手动迁移自定义内容 #

• 自定义模块：将旧实例modules目录下的自定义模块完整复制到新实例对应目录，检查module.xml中的命名空间是否适配新版本
• 已部署应用：把旧实例deployments目录下的应用包复制到新实例对应目录
• 第三方扩展：若使用了WildFly默认未内置的扩展（如特定MicroProfile组件），重新安装适配35.x版本的扩展包

四、升级验证 #

1. 启动新WildFly 35.x实例：

   ./standalone.sh（独立模式）或 ./domain.sh（域模式）
   

2. 检查启动日志：查看server.log或host-controller.log，确认无配置错误、依赖缺失等报错
3. 核对管理控制台：登录默认9990端口的管理控制台，验证数据源、系统属性、应用部署状态与旧实例一致
4. 应用功能测试：运行核心业务流程，确认应用功能正常无兼容性问题

五、关键注意事项 #

• 若应用依赖WildFly特定API，需同步升级依赖版本至35.x对应版本
• 若自动迁移后出现配置报错，可使用命令生成的备份文件回滚，再手动修改过时配置项
• 务必先在测试环境完成全流程验证，再推进生产环境升级

内容的提问来源于stack exchange，提问作者learn