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类型推断问题：PostgreSQL在执行预处理语句时，需要明确知道参数的数据类型，而原始SQL中的CONCAT函数参数类型无法被自动推断。

2. SQL语法兼容性问题：原始SQL使用了MySQL风格的CONCAT函数，这在PostgreSQL中表现不同。PostgreSQL对字符串连接有自己特定的语法要求。

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. CAST类型转换：使用CAST(#{item} AS VARCHAR)明确指定参数类型，解决PostgreSQL的类型推断问题。

2. 字符串连接操作符：使用PostgreSQL的字符串连接操作符||替代CONCAT函数，提高兼容性。

3. foreach标签：保持原有的动态SQL生成逻辑，确保能够处理多个部门编码的情况。

验证结果

修改后，系统能够正常查询部门用户信息，不再出现数据类型推断错误，功能恢复正常。

最佳实践建议

1. 在多数据库支持的项目中，应特别注意SQL语句的兼容性
2. 对于字符串操作，尽量使用标准SQL语法或提供数据库特定的实现
3. 在编写动态SQL时，应考虑边界情况（如空列表）的处理
4. 对于PostgreSQL数据库，明确指定参数类型可以避免很多潜在问题