MyBatis使用<foreach>时出现PostgreSQL near "$3"语法错误如何解决

报错中提到的$3是PostgreSQL预编译SQL的自动位置参数标识，MyBatis的#{}语法会生成JDBC预编译占位符?，PostgreSQL驱动会按顺序把这些占位符替换为$1、$2、$3...，你不需要手动编写这类变量，报错指向$3说明第三个预编译参数所在的SQL片段存在语法错误。

问题根因 #

• 字段名使用SQL保留关键字：你示例中写的column = #{item}里的column是SQL标准保留关键字，PostgreSQL解析时不会将其识别为业务字段名，导致语法异常，该位置刚好对应第三个预编译参数$3。
• 类型转换写法不符合预编译规则：date #{startDate}、date #{endDate}属于字面量类型转换语法，仅支持硬编码字符串（比如date '2024-01-01'），不能配合预编译参数使用，会导致SQL解析失败。
• 动态SQL拼接存在逻辑缺陷：你在两个日期条件后写死了and，如果入参的menu集合为空，最终生成的SQL会多出一个无后续条件的and，触发语法错误。
• 低版本MyBatis兼容性问题：你使用的MyBatis 3.0属于非常早期的版本，存在多个已知的动态SQL拼接边界bug，可能导致foreach生成的SQL缺失空格等问题。

解决方案 #

1. 处理保留关键字
   如果你的业务字段名确实为column，需要用双引号包裹标识为字段名，否则直接替换为实际的非关键字字段名即可：

<!-- 字段名为column的写法 -->
"column" = #{item}

2. 修正类型转换写法
   改用支持预编译参数的类型转换语法，推荐使用PostgreSQL专属的双冒号写法或者标准SQL的CAST语法：

<!-- 修正前 -->
where date_column >= date #{startDate} and
      date_column &lt; date #{endDate} + integer '1' and

<!-- 修正后 -->
where date_column >= #{startDate}::date and
      date_column &lt; #{endDate}::date + 1 and

3. 优化动态SQL拼接逻辑
   使用MyBatis的<where>标签自动处理多余的逻辑连接符，避免空集合导致的语法错误：

<select id="someId" parameterType="someCVO" resultType="someVO">
    ...
    <where>
        date_column >= #{startDate}::date
        and date_column &lt; #{endDate}::date + 1
        <if test="menu != null and menu.size() > 0">
            and
            <foreach collection="menu" item="item" index="index" separator="or" open="(" close=")">
                "column" = #{item}
            </foreach>
        </if>
    </where>
</select>

4. 升级MyBatis版本
   如果上述修改后仍有问题，建议将MyBatis升级到3.2及以上的稳定版本，修复老版本的动态SQL拼接bug。

内容的提问来源于stack exchange，提问作者Psymoney