JeecgBoot积木报表数据源保存报错问题分析与解决

问题现象

在使用JeecgBoot积木报表1.6.6版本时，用户在新增报表并配置数据源后，尝试保存数据源时系统报错，提示"iz_shared_source字段不能为空"的错误信息。

问题原因分析

经过深入分析，这个问题实际上是由于版本升级不完整导致的。具体原因如下：

1. 新增字段引入：在积木报表1.9.0版本中，开发团队新增了共享数据集功能，为了支持这一功能，在数据库表中添加了iz_shared_source字段。

2. 版本升级不完整：用户当前使用的是1.6.6版本，但可能部分代码或配置已经升级到了1.9.0的特性，而数据库结构却没有同步更新。

3. 字段约束冲突：系统在保存数据源时，会检查这个新增的iz_shared_source字段，但由于数据库表中缺少该字段，导致系统无法完成保存操作。

解决方案

要解决这个问题，需要采取以下步骤：

1. 执行数据库升级脚本：找到1.9.0版本的升级SQL脚本，执行其中的表结构变更语句，为相关表添加iz_shared_source字段。

2. 完整版本升级：建议将系统完整升级到1.9.0版本，确保代码和数据库结构的一致性。

3. 临时解决方案：如果暂时无法升级，可以手动在数据库中为相关表添加该字段：

   ALTER TABLE 表名 ADD COLUMN iz_shared_source tinyint(1) DEFAULT 0 COMMENT '是否共享数据源';
   

预防措施

为了避免类似问题再次发生，建议：

1. 规范升级流程：在升级报表系统时，务必按照官方文档的升级指南操作，特别是要执行相应的SQL升级脚本。

2. 版本一致性检查：升级后应验证代码版本与数据库版本是否匹配。

3. 备份机制：在执行升级操作前，做好数据库和代码的完整备份。

技术背景

积木报表的共享数据集功能是1.9.0版本引入的重要特性，它允许用户创建可在多个报表间共享的数据源配置，提高了报表开发的效率和一致性。iz_shared_source字段正是用来标识一个数据源是否为共享数据源的关键字段。

总结

数据库表结构与代码版本不匹配是开发中常见的问题，特别是在迭代升级过程中。通过这个问题，我们认识到在系统升级时保持代码和数据库同步的重要性。对于使用积木报表的开发者来说，遵循官方的升级指南，按步骤执行升级操作，可以有效避免此类问题的发生。