Grails 2.5.6迁移至3.3.8启动失败，codecLookup Bean创建异常求助

排查配置文件中的编解码器设置 #

• Grails 3.x的编解码器配置结构与2.x差异较大，检查application.yml或application.groovy，确保没有空值或空白的配置项：
  • 2.x中Config.groovy的grails.codecs.encode.'*' = 'HTML'需调整为3.x的YAML格式：

    grails:
      codecs:
        encode:
          '*': HTML
    

  • 清理所有形如grails.codecs.xxx = ''的空值配置，这类配置会导致codecLookup初始化时接收到空白参数。

检查自定义Codec实现 #

• Grails 3.x对Codec接口做了调整，2.x中实现org.codehaus.groovy.grails.plugins.codecs.CodecFactory的自定义Codec，需改为实现grails.plugins.codecs.Codec、grails.plugins.codecs.Encoder或grails.plugins.codecs.Decoder接口。
• 确认自定义Codec的构造函数或初始化逻辑没有依赖未配置的字符串参数，若存在通过配置注入的参数，需确保对应配置项有有效值。

排查插件依赖问题 #

• 暂时禁用非核心插件，逐个重新启用，定位是否由某个第三方插件引入了错误的codec配置。
• 验证所有插件版本适配Grails 3.3.8，老旧插件可能未适配3.x的codec体系，导致传递空配置参数。

清理遗留的2.x配置 #

• 确保已完全将Config.groovy的配置迁移至application.yml/application.groovy，删除残留的Config.groovy文件，避免配置合并冲突。
• 移除手动注册codec的遗留代码，Grails 3.x会自动扫描并注册符合规范的Codec类，无需手动配置codecLookup Bean。

日志定位具体问题 #

• 启用Debug日志，查看codecLookup初始化时的详细参数：
  在logback.groovy中添加日志配置：

  logger('org.springframework.beans.factory.support', DEBUG, ['STDOUT'], false)
  logger('grails.plugins.codecs', DEBUG, ['STDOUT'], false)
  

  通过日志输出定位到具体为空的字符串参数，针对性修复对应配置或代码。

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