MyBatis报BindingException：参数'pod'未找到，求排查解决

错误原因 #

你遇到的BindingException是因为在**@Select注解中直接使用MyBatis动态SQL标签（如<foreach>）但未用<script>包裹**。MyBatis对注解形式的SQL默认只会处理简单的参数替换，不会解析XML风格的动态标签，导致<foreach>里的临时变量pod无法被识别，最终抛出参数未找到的异常。

修复方案 #

把@Select中的整个SQL语句用<script>标签包裹，让MyBatis触发动态SQL解析逻辑，正确识别<foreach>标签并创建遍历所需的临时变量。

修复后的代码示例 #

@Select("<script>" +
        "SELECT im.*, po.id AS podId " +
        "FROM instance_monitor im " +
        "JOIN pod po ON im.name = po.name " +
        "WHERE im.update_time BETWEEN #{startTime} AND #{endTime} " +
        "  AND im.env_id = #{envId} " +
        "  AND im.name IN  " +
        "  <foreach item='pod' index='index' collection='pods' open='(' separator=',' close=')'>   " +
        "    #{pod.podName} " +
        "  </foreach>" +
        "</script>")
List<InstanceMonitorDto> getPodByName(@Param("pods")List<Pod> pods, @Param("startTime") LocalDateTime startTime, @Param("endTime") LocalDateTime endTime,
                                      @Param("envId") Integer envId);

额外说明 #

• 所有在注解中使用的MyBatis动态SQL标签（如<if>、<foreach>、<choose>等）都必须包裹在<script>标签内，否则MyBatis会将其视为普通SQL字符串，无法解析动态逻辑。
• 确认你的Pod类确实存在podName属性，并且有对应的getter方法，否则即使解析了<foreach>，依然会抛出属性未找到的异常。

内容的提问来源于stack exchange，提问作者曾廉洁