MyBatis中ORDER BY字段必须白名单校验,禁用${sort}直接拼接;应使用枚举或Map预定义合法字段与方向,并双重校验;分页参数须用#{offset}#{pageSize}绑定,禁用${}拼接;PageHelper不防排序注入,需手动校验。

MyBatis 里 ORDER BY 字段必须白名单校验
直接把用户传的 sort=created_at DESC 塞进 ${sort} 是高危操作,${} 是字符串原样替换,数据库根本不会做参数绑定。哪怕你对值做了 trim() 或正则过滤,只要没覆盖所有合法组合(比如 id ASC、status DESC),攻击者就能用 id; DROP TABLE users-- 触发注入。
正确做法是在 Java 层用枚举或静态 Map 预定义所有允许的排序项:
Map.of("id", "id", "name", "name", "created_at", "created_at")- 再加一个方向校验:
if (!List.of("ASC", "DESC").contains(direction.toUpperCase())) throw new IllegalArgumentException(); - XML 中只拼接已验证的字段:
ORDER BY ${safeSortField} ${safeSortDirection}
分页参数必须走 #{} 绑定,不能用 ${}
LIMIT #{offset}, #{pageSize} 安全;LIMIT ${offset}, ${pageSize} 危险。因为 offset 和 pageSize 是数值型“数据”,不是 SQL 结构,完全支持 PreparedStatement 占位符。MySQL、PostgreSQL、SQLite 都认 LIMIT ?, ? 这种写法。
常见错误是误以为分页参数也要动态拼,结果写成 LIMIT ${page * size}, ${size}——这等于把计算逻辑暴露在字符串拼接层,一旦 page 被篡改为 1; SELECT SLEEP(5)--,整个查询就失控。
注意点:
- offset 必须是非负整数,建议在 Controller 层校验:
if (page 100) throw ... - MySQL 的
LIMIT 18446744073709551615会触发整数溢出,导致全表扫描,所以 pageSize 上限要硬限制
PageHelper 插件能自动拦截分页,但不解决排序安全
PageHelper.startPage(pageNum, pageSize) 确实能帮你省掉手写 LIMIT,但它**完全不管 ORDER BY**。如果你在 XML 里写 ORDER BY ${sortField},PageHelper 不会校验、不会替换、也不会报错。
也就是说:分页安全靠插件兜底,排序安全还得自己守门。典型错误写法:
<select id="listUsers">
SELECT * FROM users
<where>
<if test="name != null">name LIKE CONCAT('%', #{name}, '%')</if>
</where>
ORDER BY ${sort} <!-- 这里仍是注入点 -->
</select>修复方式只有两个选择:
- 把
${sort}换成${safeSort},且确保传入的safeSort已经过白名单检查 - 改用
<bind></bind>+ OGNL 表达式在 XML 内部做简单映射(仅限字段名,不含方向):<bind name="safeOrder" value="@com.example.util.SortUtil@validate(sort)"></bind>
MyBatis-Plus 的 QueryWrapper 不防排序注入
QueryWrapper.orderByAsc("name") 是类型安全的,没问题;但 QueryWrapper.orderBy(true, true, userSortInput) 就危险——这个 userSortInput 如果来自前端未校验的字符串,就会被原样拼进 SQL。
MyBatis-Plus 的 orderBy 系列方法底层仍走字符串拼接,它只保证值参数(如 WHERE 条件)走 #{},但排序字段属于 SQL 结构,框架无法自动参数化。
所以实际使用中必须:
- 禁用自由传入字段名的
orderBy重载方法 - 封装一层校验工具类,比如
SortClause.from(userInput).toSql(),内部只返回预设白名单中的字段+方向组合 - 在单元测试里加一条用
sort=id; DROP TABLE--当输入的 case,确认抛出异常而非执行
最易被忽略的一点:排序字段和方向是两个独立变量,白名单必须同时校验二者组合,不能只校验字段名。比如 status ASC 合法,status DESC 也合法,但 status; TRUNCATE logs 即使字段名在白单里,也因包含非法字符被拒。

















