如何将Grails应用从2.4.4版本升级到4.0.1版本？

升级前置准备 #

• 先跑通当前 2.4.4 版本的全部测试用例，留存功能基线，提前做全量快照备份（代码、数据库、依赖缓存），避免升级失败无法回滚
• 先清理当前代码内所有标记@Deprecated的废弃API、非标准动态查找器用法、过时的第三方插件依赖，在2.4.4版本内全部替换为兼容写法后再启动升级流程

核心升级路径（避免跳级，效率最高） #

不要直接跨大版本从2.x升4.x，按照「小步快跑」的递进方式升级，出现问题可以快速定位原因：

第一步：2.4.4 → 2.5.6（2.x最终稳定版） #

• 修改application.properties中的app.grails.version=2.5.6
• 依次执行grails clean、grails compile，解决插件、依赖的版本冲突，所有插件都要替换为2.5.x兼容版本
• 跑完全部测试，确认功能无异常后再进入下一个阶段，该阶段改动量极小，常规项目半天即可完成

第二步：2.5.6 → 3.0.17（3.0最终稳定版） #

该阶段是架构变更最大的节点：Grails从2.x的Servlet2.5架构切换为Spring Boot为基础的Servlet3.1+架构，项目结构、配置文件格式、依赖管理逻辑全部重构

• 直接新建一个3.0.17的空白项目，按照新的项目结构迁移业务代码：domain、controller、service、视图文件分别移入grails-app下的对应目录，静态资源移入src/main/resources/public
• 依赖配置从BuildConfig.groovy迁移到build.gradle，2.x的插件全部替换为3.0兼容版本，无兼容版本的插件优先找替代方案，或自行实现相关逻辑
• 配置项迁移：将原有Config.groovy、DataSource.groovy里的配置逐行转换为application.yml的对应格式，数据源、日志、自定义配置项要逐一核对
• 解决基础API变更问题：比如Holders.getApplicationContext()的写法调整、旧标签库适配、GORM方法语法调整，全部测试跑通后进入下一阶段

第三步：3.0.17 → 3.3.16（3.x最终稳定版） #

• 修改build.gradle中的Grails版本为3.3.16，同步将Gradle版本升级到4.x对应版本
• 适配GORM 6.x的变更：调整where查询语法、关联查询懒加载规则的适配
• 替换废弃依赖：比如旧的rest-client-builder替换为对应版本的新工具，调整logback日志配置适配新版本
• 全量测试跑通后进入下一阶段

第四步：3.3.16 → 4.0.1 #

• 修改build.gradle中的Grails版本为4.0.1，同步将Gradle版本升级到5.x，Spring Boot版本对应升级到2.1.x分支版本
• 适配GORM 7.x的变更：调整校验规则、多数据源配置逻辑
• 替换不兼容插件：3.x的部分插件无4.0兼容版本，优先找官方Spring Boot Starter替代，比如旧的Shiro插件可以用Apache Shiro官方的Starter做适配
• 调整拦截器、静态资源引用逻辑，全量测试跑通后做功能验收

实操踩坑经验 #

• 所有依赖、插件版本必须严格匹配Grails官方的版本矩阵，不要随意升级单个依赖的小版本，非常容易出现隐性不兼容问题
• 数据库变更优先用数据库迁移插件管控，不要开启自动DDL，避免数据丢失，每升级一个大版本都要单独验证数据库结构兼容性
• 自定义标签库、拦截器、Servlet过滤器是高风险修改点，3.x阶段要逐一验证功能，避免出现隐性逻辑错误
• 如果之前用Grails2自带的Resource插件管理静态资源，3.x之后要替换为Asset-Pipeline插件，同步调整全部静态资源引用路径

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