Grails 4.0.3应用处理RabbitMQ队列时报Date.format()方法签名错误

你碰到的No signature of method: java.util.Date.format()报错，本质是Groovy为java.util.Date提供的扩展方法未被当前运行上下文加载，不是业务代码的语法错误。Grails 4.0.3默认绑定Groovy 2.5.x版本，该版本中Date.format(String pattern)是Groovy内置的扩展方法，正常运行时不会抛出方法不存在的异常。服务稳定运行一年后突发该问题，基本都是依赖版本被覆盖、或者RabbitMQ消费者线程类加载器隔离导致的。

用以下任意一种方法即可查到准确版本，不需要翻官方文档：

• 项目根目录执行Gradle依赖查询命令：Linux/macOS环境运行./gradlew dependencies | grep groovy，Windows环境运行gradlew.bat dependencies | findstr groovy，输出结果中org.codehaus.groovy:groovy对应的版本号就是实际编译、运行时使用的Groovy版本
• 在任意可触发的业务逻辑中加入一行打印代码println GroovySystem.getVersion()，启动服务后控制台输出的字符串就是当前Groovy版本
• 直接查看部署包内的依赖目录：解压构建生成的war/jar包，进入WEB-INF/lib（war包）或者BOOT-INF/lib（可执行jar包）目录，找到groovy-*.jar文件，文件名中标注的版本号即为实际使用的版本

场景1：Groovy版本被覆盖为3.0及以上 #

Grails 4.x系列最高只适配Groovy 2.5.x版本，Groovy 3+对JDK扩展方法做了裁剪、类路径结构也有调整，会导致扩展方法加载失败。直接在build.gradle中加入版本强制锁定规则，重新打包部署即可：

configurations.all {
    resolutionStrategy {
        force 'org.codehaus.groovy:groovy-all:2.5.6'
        force 'org.codehaus.groovy:groovy:2.5.6'
        force 'org.codehaus.groovy:groovy-dateutil:2.5.6'
    }
}

注：2.5.6是Grails 4.0.3官方默认绑定的Groovy版本，不要在Grails 4.x项目中跨大版本升级Groovy。

场景2：Groovy版本为2.5.x仍报错 #

这种情况是RabbitMQ消费者线程使用了独立的类加载器，没有加载到Groovy的扩展方法元数据，两种修复方式二选一即可：

• 稳妥方案：把消费逻辑中所有调用Date.format(String)的代码替换为JDK原生实现，不依赖Groovy扩展方法，示例：

  // 原Groovy扩展写法
  // def dateStr = new Date().format("yyyy-MM-dd")
  // 替换为JDK原生写法
  import java.text.SimpleDateFormat
  def dateStr = new SimpleDateFormat("yyyy-MM-dd").format(new Date())
  // 推荐使用Java 8+时间API，不存在线程安全问题
  import java.time.LocalDate
  import java.time.format.DateTimeFormatter
  def dateStr = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd"))
  

• 快速方案：调整RabbitMQ消费者的线程池配置，把上下文类加载器设置为应用主类加载器，即可正常加载Groovy扩展方法。

如果线上队列堆积需要立刻恢复，优先把消费链路中所有用到Date.format()的位置替换为JDK原生写法，打包上线后即可立刻恢复消费，后续再慢慢梳理依赖冲突的具体来源。

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