JimuReport集成若依3.2.0版本启动报错解决方案

JimuReport集成若依3.2.0版本启动报错解决方案

【免费下载链接】jimureport 「数据可视化工具：报表、大屏、仪表盘」积木报表是一款类Excel操作风格，在线拖拽设计的报表工具和和数据可视化产品。功能涵盖: 报表设计、大屏设计、打印设计、图形报表、仪表盘门户设计等，完全免费！秉承“简单、易用、专业”的产品理念，极大的降低报表开发难度、缩短开发周期、解决各类报表难题。 项目地址: https://gitcode.com/jeecgboot/jimureport

在将JimuReport报表系统集成到若依（RuoYi）3.2.0版本（Spring Boot 2.2.6.RELEASE）的过程中，部分开发者遇到了启动报错的问题。错误信息通常表现为类加载冲突或类型转换异常，具体可能与fastjson相关。这类问题的根源在于类加载器的差异，需要针对性地调整配置以解决。

问题分析

若依3.2.0版本默认集成了spring-boot-devtools工具，用于实现热加载功能。该工具会使用RestartClassLoader来重新加载项目中的类，而第三方JAR包中的类则由默认的Launcher$AppClassLoader加载。当两个不同的类加载器加载的类存在相互引用时，就可能出现类冲突或类型转换异常。

在本案例中，若依配置将fastjson的JAR包包含在devtools的加载范围内，但JimuReport并未使用devtools，却引用了fastjson，导致同一个类被两个不同的类加载器加载，从而引发错误。

解决方案

针对这一问题，提供以下两种解决方案，开发者可根据实际情况选择其中一种。

方案一：调整devtools配置

1. 找到若依项目中的配置文件：ruoyi-admin/src/main/resources/META-INF/spring-devtools.properties
2. 打开该文件，找到包含fastjson配置的行，通常为：restart.include.json=/com.alibaba.fastjson.*.jar
3. 在该行前添加注释符号#，将其注释掉，修改后如下：

   #restart.include.json=/com.alibaba.fastjson.*.jar
   

4. 保存文件并重新启动项目。

此方法通过排除fastjson从devtools的加载范围，避免了类加载器冲突。

方案二：移除devtools依赖（推荐）

1. 打开若依项目的pom.xml文件。
2. 找到spring-boot-devtools的依赖配置，通常如下：

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-devtools</artifactId>
       <scope>runtime</scope>
       <optional>true</optional>
   </dependency>
   

3. 将该依赖配置注释或删除。
4. 保存文件并重新构建项目。

此方案彻底移除了devtools，从根本上避免了类加载器冲突的问题。对于热加载需求，建议使用专业的工具如JRebel来替代devtools，它们通常具有更好的兼容性和稳定性。

总结

JimuReport与若依框架集成时遇到的启动报错，主要是由于spring-boot-devtools工具引起的类加载器冲突。通过调整devtools配置或直接移除该依赖，可以有效解决这一问题。建议采用方案二，即移除devtools依赖，并使用更专业的热加载工具，以确保项目的稳定性和开发效率。

在框架集成过程中，类加载器冲突是一个常见但容易被忽视的问题。开发者应当注意不同模块的依赖管理，避免类似的冲突发生，保证项目的顺利运行。

【免费下载链接】jimureport 「数据可视化工具：报表、大屏、仪表盘」积木报表是一款类Excel操作风格，在线拖拽设计的报表工具和和数据可视化产品。功能涵盖: 报表设计、大屏设计、打印设计、图形报表、仪表盘门户设计等，完全免费！秉承“简单、易用、专业”的产品理念，极大的降低报表开发难度、缩短开发周期、解决各类报表难题。 项目地址: https://gitcode.com/jeecgboot/jimureport