JeecgBoot项目中积木报表与Fastjson版本兼容性问题解析

问题背景

在JeecgBoot项目的1.7.9版本中，当开发者使用Spring Boot 2集成积木报表功能时，前端页面出现了JSON解析错误。具体表现为在访问报表列表页面并尝试新建报表时，控制台报出"Unexpected end of JSON input"的错误。

问题现象分析

错误发生在获取报表配置的JavaScript函数中：

function getReportConfigJson() {
    let str = '';
    return JSON.parse(str)
}

这个函数尝试将一个空字符串解析为JSON对象，显然会导致语法错误。正常情况下，这里应该从后端获取有效的报表配置数据。

根本原因

经过深入排查，发现问题的根源在于项目中使用的Fastjson版本。项目当前使用的是Fastjson2 2.0.5版本，而积木报表功能需要依赖Fastjson 1.2.83版本才能正常工作。这种版本不兼容导致了后端无法正确返回报表配置数据。

解决方案

对于这个问题，开发者有以下几种解决方案：

1. 降级Fastjson版本：将项目中的Fastjson降级到1.2.83版本。这种方法简单直接，但可能会影响项目中其他依赖Fastjson2的功能模块。

2. 升级积木报表版本：考虑将项目迁移到Spring Boot 3版本，该版本的积木报表已经支持Fastjson2.x。这是官方推荐的长期解决方案。

3. 版本隔离：通过类加载器隔离等技术手段，使积木报表和项目其他部分使用不同版本的Fastjson。这种方法技术复杂度较高，但可以保持现有功能不变。

技术建议

对于大多数项目，建议采用第二种方案，即升级到Spring Boot 3版本的积木报表。这不仅能解决Fastjson的版本冲突问题，还能获得最新的功能和安全更新。

如果暂时无法升级整个项目框架，可以考虑以下临时解决方案：

1. 在项目中同时保留Fastjson和Fastjson2的依赖
2. 为积木报表功能单独配置使用Fastjson 1.2.83
3. 通过@Bean配置确保积木报表相关组件使用正确的JSON处理器

总结

JSON处理库的版本冲突是Java项目中常见的问题。JeecgBoot积木报表与Fastjson的版本兼容性问题提醒我们，在引入新组件时需要特别注意其依赖关系。通过合理规划技术栈和及时更新组件版本，可以有效避免这类问题的发生。