JeecgBoot项目PostgreSQL数据库查询部门用户信息报错分析与修复

问题背景

在使用JeecgBoot 3.7.2版本时，当系统管理员在"系统管理>我的部门>用户信息"模块进行用户信息查询操作时，PostgreSQL数据库环境下会出现SQL查询错误。该错误主要发生在用户负责的部门列表为空的情况下。

错误现象

系统抛出以下异常信息：

错误: 无法确定参数 $1 的数据类型

具体错误指向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(?, '%'))

问题分析

1. 数据库兼容性问题：PostgreSQL与MySQL在字符串连接处理上存在语法差异
2. 参数类型推断问题：PostgreSQL对参数类型的严格检查导致无法自动推断CONCAT函数参数类型
3. 空列表处理：当负责部门列表为空时，SQL语句构造出现异常

解决方案

修改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的字符串连接操作符||替代MySQL的CONCAT函数
2. 使用CAST(#{item} AS VARCHAR)显式指定参数类型
3. 保持原有的逻辑结构不变，仅修改语法细节

技术原理

PostgreSQL对SQL标准的实现较为严格，特别是在参数类型推断方面。当使用CONCAT函数时，PostgreSQL需要明确知道每个参数的数据类型才能执行查询。而MySQL在这方面则更加宽松，能够自动进行类型转换。

在字符串连接操作上：

• MySQL使用CONCAT(str1, str2)函数
• PostgreSQL使用str1 || str2操作符

验证结果

修改后重新执行查询操作，系统能够正常返回查询结果，不再出现参数类型推断错误。

最佳实践建议

1. 在跨数据库项目中，应尽量避免使用数据库特定的函数和语法
2. 对于字符串操作，可以考虑使用MyBatis提供的字符串处理函数
3. 对于关键查询，建议进行充分的跨数据库测试
4. 在条件构造时，应考虑空集合等边界情况的处理

此修复方案已在JeecgBoot 3.7.2版本中验证通过，能够有效解决PostgreSQL环境下部门用户信息查询报错问题。