MyBatis中GROUP BY字段不能用#{},因其仅支持值参数,而GROUP BY后必须是列名(SQL语法片段),#{}会自动加引号导致语法错误;必须用${}时,须通过白名单校验字段、结合和安全拼接,严禁直接拼接用户输入。

MyBatis里GROUP BY字段为什么不能用#{}
因为#{}只接受值参数,而GROUP BY后必须是列名(语法片段),不是数据值。数据库在预编译阶段需要知道分组结构,比如GROUP BY user_id, status——这整段属于SQL语法的一部分,不能被替换成?占位符。一旦强行用#{groupFields},MyBatis会自动给它加单引号,最终生成类似GROUP BY 'user_id, status'的非法SQL,直接报错ORA-00979: not a GROUP BY expression或MySQL的Unknown column 'user_id, status' in 'group statement'。
必须用${}时怎么防注入
${}本身不防注入,所以不能直接拼接用户输入。安全路径只有一条:把用户可选的分组字段限定在白名单内,再做映射校验。
- 前端传过来的字段名(如
"status"、"create_date")必须是预定义的合法列名,不能是任意字符串 - 后端接收后,先查白名单Map:
Map.of("status", "status", "type", "item_type", "date", "DATE(created_at)") - 若找不到对应key,直接拒绝请求,不进入SQL拼接环节
- 白名单值中允许简单表达式(如
DATE(created_at)),但禁止含括号嵌套、子查询、函数调用等高风险结构
示例Java校验逻辑:
private static final Map<String, String> GROUP_BY_WHITELIST = Map.of(
"status", "status",
"type", "item_type",
"day", "DATE(created_at)"
);
public String resolveGroupByField(String userInput) {
String safeField = GROUP_BY_WHITELIST.get(userInput);
if (safeField == null) {
throw new IllegalArgumentException("Invalid group-by field: " + userInput);
}
return safeField;
}
XML中<if></if>和<foreach></foreach>怎么组合才安全
多字段分组(如GROUP BY status, type)不能靠字符串拼接,得用MyBatis内置标签控制结构,避免手写${}拼接逻辑。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;
- 用
<if test="groupByFields != null and !groupByFields.isEmpty()"></if>包裹整个GROUP BY子句,确保无分组时不生成该关键词 - 用
<foreach collection="groupByFields" item="field" separator=", ">${field}</foreach>遍历白名单校验后的字段列表 -
separator必须设为", ",不能为空或","(逗号后缺空格易引发解析歧义) - 绝对不要在
<foreach></foreach>内部再套${}或#{}——field必须已是校验通过的纯列名字符串
XML片段示例:
<select id="dynamicGroupQuery" resultType="Map">
SELECT ${selectFields} FROM orders
<if test="groupByFields != null and !groupByFields.isEmpty()">
GROUP BY
<foreach collection="groupByFields" item="field" separator=", ">
${field}
</foreach>
</if>
</select>
容易被忽略的边界点
白名单校验必须发生在DAO层入口,而不是Service层之后;字段名大小写要和数据库实际列一致(MySQL默认不区分,PostgreSQL严格区分);GROUP BY字段若含表达式(如UPPER(name)),必须提前收进白名单,不能运行时动态构造;当用户选择“不分组”时,SQL里不能留空GROUP BY,否则MySQL 5.7+会报ONLY_FULL_GROUP_BY错误——此时应整个移除GROUP BY子句,而非传入空字符串。

















