JeecgBoot项目PostgreSQL数据库下部门查询问题解析与修复

问题背景

在JeecgBoot 3.7.2版本中，当使用PostgreSQL数据库时，系统管理模块的"我的部门>用户信息"查询功能会出现异常。该问题主要发生在用户负责的部门列表为空的情况下，系统会抛出SQL语法错误。

错误现象分析

当用户执行部门用户查询操作时，系统后台会尝试执行以下SQL查询：

SELECT id FROM sys_depart 
WHERE del_flag = '0' 
AND (org_code LIKE CONCAT(?, '%') OR org_code LIKE CONCAT(?, '%') OR org_code LIKE CONCAT(?, '%'))

在PostgreSQL环境下，这个查询会抛出错误："无法确定参数 $1 的数据类型"。这是因为PostgreSQL对参数类型的严格检查机制与MySQL不同，特别是在处理CONCAT函数和LIKE操作符时。

根本原因

1. 数据库兼容性问题：原始SQL使用了MySQL风格的CONCAT函数，这在PostgreSQL中表现不同
2. 参数类型推断失败：PostgreSQL无法自动推断CONCAT函数中参数的类型
3. 空列表处理不当：当用户没有负责任何部门时，查询条件生成逻辑存在缺陷

解决方案

针对PostgreSQL数据库，我们需要修改SysDepartMapper.xml文件中的SQL语句，使用PostgreSQL特有的语法：

<select id="getSubDepIdsByOrgCodes" resultType="java.lang.String">
    SELECT id 
    FROM sys_depart 
    WHERE del_flag = '0' 
      AND (
          <foreach collection="orgCodes" item="item" index="index" open="(" separator=" OR " close=")">
              org_code LIKE CAST(#{item} AS VARCHAR) || '%'
          </foreach>
      )
</select>

关键改进点：

1. 使用PostgreSQL的字符串连接操作符||替代CONCAT函数
2. 使用CAST显式指定参数类型为VARCHAR
3. 保留原有的foreach循环结构，确保多条件查询的正常工作

技术原理

PostgreSQL在处理LIKE操作时，要求操作数具有明确的数据类型。当使用参数化查询时，数据库引擎需要知道参数的类型才能正确执行查询。通过CAST显式转换，我们确保了类型安全，避免了引擎的类型推断问题。

字符串连接操作符||是PostgreSQL中连接字符串的标准方式，相比CONCAT函数，它更符合PostgreSQL的语法规范，且性能更优。

验证结果

修改后，系统在以下场景下均能正常工作：

1. 用户有负责部门时的查询
2. 用户无负责部门时的查询
3. 各种边界条件下的部门编码匹配

查询界面恢复正常，不再出现数据类型错误提示，用户体验得到显著提升。

最佳实践建议

对于多数据库支持的项目，建议：

1. 为不同数据库维护单独的SQL映射文件
2. 使用数据库方言检测机制动态选择正确的SQL语句
3. 在单元测试中覆盖所有支持的数据库类型
4. 对于字符串操作，特别注意各数据库的语法差异

通过这次问题的解决，我们不仅修复了一个具体的bug，更重要的是加深了对数据库兼容性问题的理解，为今后处理类似问题积累了宝贵经验。