Spring JDBC中用MapSqlParameterSource做动态查询缺参数报错如何解决？

你可以通过在固定SQL语句中加入空值判断逻辑实现动态过滤，不需要调整SQL结构，仅需按规则传参即可，具体实现如下：

方案1：SQL层增加空值分支判断（最常用） #

调整后的固定查询语句 #

SELECT * FROM users 
WHERE 
  (name = :name OR :name IS NULL)
  AND (class = :class OR :class IS NULL);

逻辑说明 #

• 当某参数传入null时，对应的OR :参数名 IS NULL条件会生效，整段括号内的过滤条件整体为真，等于跳过该字段的过滤
• 当参数有有效值时，会按正常的等值匹配规则过滤

参数构造示例 #

无论前端是否传对应参数，都统一给所有SQL中定义的参数赋值，未收到前端传值的字段赋值为null即可：

MapSqlParameterSource params = new MapSqlParameterSource();
params.addValue("name", request.params.name);
// 前端未传class时直接赋值为null，不会触发该字段过滤
params.addValue("class", request.params.class);
// 执行查询不会报错

特殊场景兼容 #

如果你的业务中name或class字段本身允许存储null值，需要查询字段为null的记录时，可将对应条件替换为PostgreSQL特有的非差异比较语法，避免null值匹配失效：

-- 替换原来的(class = :class OR :class IS NULL)
(:class IS NULL OR class IS NOT DISTINCT FROM :class)

方案2：动态拼接SQL（可选，适合过滤字段较多的场景） #

如果过滤字段较多，担心SQL的OR条件影响查询效率，可使用Spring自带的SqlBuilder工具类动态拼接WHERE条件，本质上也是仅写一次SQL构造逻辑，不需要每次修改：

SqlBuilder sqlBuilder = new SqlBuilder();
sqlBuilder.append("SELECT * FROM users WHERE 1=1 ");
if (request.params.name != null) {
  sqlBuilder.append("AND name = :name ");
  params.addValue("name", request.params.name);
}
if (request.params.class != null) {
  sqlBuilder.append("AND class = :class ");
  params.addValue("class", request.params.class);
}
String sql = sqlBuilder.toString();
// 执行查询

该方案生成的SQL没有多余的判断条件，执行效率更高。

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