Grails 4使用rendering:2.0.3插件时出现ImageRenderingService类加载失败编译错误

该类加载异常本质是rendering插件版本与Grails 4的适配性不匹配：

• 2.0.3版本的rendering插件原生面向Grails 3生态设计，未针对Grails 4的模块化类加载机制做适配
• 该版本中grails.plugins.rendering.image.ImageRenderingService的类扫描路径没有在Grails 4可识别的插件描述符中注册，编译阶段类加载器无法定位到对应类文件，直接触发加载失败
• 即便手动引入对应类文件，2.0.3版本依赖的底层PDF渲染组件版本与Grails 4内置依赖存在版本冲突，后续运行阶段还会触发其他兼容性异常

• 替换build.gradle中的rendering插件依赖版本，移除2.0.3版本的引用，更换为适配Grails 4的3.x稳定版本，对应依赖写法为：

implementation "org.grails.plugins:rendering:3.0.0"

• 清理本地残留的旧版本依赖缓存，执行编译清理命令：./gradlew clean，手动删除项目根目录下的build文件夹、.gradle缓存目录中残留的2.0.3版本rendering插件jar包，避免类加载器优先加载旧版本残留文件
• 检查项目全局类加载隔离配置，确保grails.plugins.rendering.*包路径没有被加入类加载排除列表，否则即便更换正确版本的插件，也会因路径被拦截触发类加载失败
• 调整业务代码中的服务注入逻辑：Grails 4适配的3.x版本rendering插件，会将ImageRenderingService正常注册为Spring Bean，无需通过反射手动加载类，直接按常规Grails服务注入方式引用即可

不要为了兼容旧代码将2.0.3版本的插件jar包手动放入项目lib目录强行加载，这种方式会绕开插件的依赖自动管理逻辑，引发依赖版本乱序、类冲突等难以排查的连锁问题。

内容的提问来源于stack exchange，提问作者Gelberth Amarillo Rojas