JeecgBoot项目迁移至达梦数据库的大小写问题解决方案

背景介绍

在将JeecgBoot项目从原有数据库迁移至达梦数据库(DM)时，开发人员可能会遇到表名和字段名大小写敏感性问题。这主要是因为达梦数据库默认情况下对标识符(表名、列名等)是区分大小写的，而JeecgBoot项目中使用的SQL语句通常采用小写或混合大小写形式。

问题现象

迁移后系统运行时会出现类似以下错误：

无效的列名[DEL_FLAG]

这表明数据库无法识别SQL语句中指定的大小写形式的列名，即使该列实际存在于表中。

根本原因

达梦数据库的标识符处理机制与MySQL等数据库有所不同：

1. 默认情况下，达梦对标识符区分大小写
2. 即使设置了不区分大小写(CASE_SENSITIVE=0)，查询时字段名仍可能被转换为大写
3. JeecgBoot生成的SQL语句中使用的列名大小写形式与数据库预期不符

解决方案

方案一：配置数据库不区分大小写

1. 修改达梦数据库配置文件dm.ini
2. 找到并设置参数：CASE_SENSITIVE=0
3. 重启数据库服务使配置生效

此方案可以解决表名大小写问题，但可能无法完全解决列名问题。

方案二：统一SQL语句中的标识符大小写

1. 检查所有Mapper文件中的SQL语句
2. 确保SQL中使用的表名和列名与数据库中的实际名称完全一致
3. 对于达梦数据库，建议统一使用大写形式

方案三：使用引号包裹标识符

在SQL语句中为所有标识符添加双引号：

SELECT "ID", "USERNAME", "REALNAME" FROM "SYS_USER" WHERE "DEL_FLAG" = 0

这种方式可以精确匹配标识符的大小写形式。

最佳实践建议

1. 在项目初期就确定数据库标识符命名规范，建议统一使用大写
2. 使用数据库迁移工具时，注意检查生成的对象名称大小写
3. 对于JeecgBoot项目，可以考虑修改代码生成模板，使其适应达梦数据库的要求
4. 在数据库连接配置中增加参数：<property name="remarksReporting" value="true"/>，以获取准确的元数据信息

后续维护

1. 建立数据库对象命名规范文档
2. 在CI/CD流程中加入数据库兼容性检查
3. 定期审核SQL语句，确保与目标数据库的兼容性

通过以上措施，可以确保JeecgBoot项目在达梦数据库环境下稳定运行，避免因大小写问题导致的系统异常。