
本文详解如何彻底消除 SonarQube 报出的 Session.createQuery(String) HQL 注入风险,核心在于禁用任意外部可控字符串构造 HQL,改用白名单驱动的查询构建与参数化绑定。
本文详解如何彻底消除 sonarqube 报出的 `session.createquery(string)` hql 注入风险,核心在于禁用任意外部可控字符串构造 hql,改用白名单驱动的查询构建与参数化绑定。
该漏洞的根本原因并非出在 setParameter() 的使用上(您已正确使用命名参数),而在于 createQuery(String) 被调用了两次完全不受控的、由运行时拼接生成的 HQL 字符串:
-
Query query = getSessionFactory().getCurrentSession().createQuery(queryString); Query countQuery = createQuery(new StringBuffer().append(count).append(join).append(clause).toString());
尽管 queryString 由多个 StringBuilder 拼接而成,且 WHERE 子句中的值均通过 setParameter() 绑定(这是安全的),但 ORDER BY、JOIN 和部分 WHERE 结构本身(如字段名、关联路径、排序方向)是直接拼入字符串的。例如:
// ⚠️ 危险:sortField 来自 CatalogFilterVO(可能来自 HTTP 请求),未经校验即拼入 HQL
if (NOMENCLATURE_ONE.equalsIgnoreCase(catalogFilter.getSortField())) {
orderByP2.append(" ORDER BY n.parent.parent.parent.parent.label");
}
// ...
orderByP2.append(" ").append(catalogFilter.getSortOrder()); // "ASC" or "DESC"? 未校验!攻击者若能控制 catalogFilter.getSortField() 或 catalogFilter.getSortOrder()(如传入 "label) OR 1=1 --" 或 "DESC, (SELECT password FROM users)"),即可注入恶意 HQL,绕过参数绑定机制。
✅ 正确修复方案:白名单 + 构建器模式
1. 移除不安全的公共 createQuery(String) 方法
删除以下高危方法(它为任意字符串开后门):
// ❌ 删除此方法
public Query createQuery(String query) {
return sessionFactory.getCurrentSession().createQuery(query);
}2. 对所有动态片段实施严格白名单校验
对所有可能被用户输入影响的 HQL 结构(ORDER BY 字段、JOIN 条件、SORT ORDER),定义明确枚举或静态映射:
// ✅ 白名单:合法排序字段与对应 HQL 路径
private static final Map<String, String> SORT_FIELD_TO_HQL = Map.of(
"nomenclatureOne", "n.parent.parent.parent.parent.label",
"nomenclatureTwo", "n.parent.parent.parent.label",
"nomenclatureThree", "n.parent.parent.label",
"nomenclatureFour", "n.parent.label",
"nomenclatureFive", "n.label",
"name", "mp.name",
"partnerProductReference", "mp.partnerProductReference"
);
// ✅ 白名单:仅允许 ASC/DESC
private static final Set<String> VALID_SORT_ORDERS = Set.of("ASC", "DESC");
// ✅ 在构建 ORDER BY 前强制校验
private StringBuilder paginatedListMasterProductOrderByAllFieldQuery(CatalogFilterVO catalogFilter) {
StringBuilder orderBy = new StringBuilder();
String sortField = catalogFilter.getSortField();
String sortOrder = StringUtils.defaultString(catalogFilter.getSortOrder(), "ASC").toUpperCase();
// 校验排序字段
if (SORT_FIELD_TO_HQL.containsKey(sortField)) {
orderBy.append(" ORDER BY ").append(SORT_FIELD_TO_HQL.get(sortField));
} else if ("textSearch".equals(sortField)) {
orderBy.append(paginatedListMasterProductOrderByTextSearch(catalogFilter));
} else {
// 默认安全排序(如主键)
orderBy.append(" ORDER BY mp.id");
}
// 校验排序方向
if (VALID_SORT_ORDERS.contains(sortOrder)) {
orderBy.append(" ").append(sortOrder);
} else {
orderBy.append(" ASC"); // 默认降级
}
if (StringUtils.isNotEmpty(catalogFilter.getTextSearch())) {
orderBy.append(", CASE WHEN ... END"); // 此处仍需确保内部无注入
}
return orderBy;
}3. 使用 Criteria API(推荐,更安全、类型安全)
Hibernate 5.2+ 推荐使用 JPA CriteriaBuilder 替代字符串拼接,从根本上杜绝 HQL 注入:
public List<MasterProduct> getAllMasterProductsByNomenclatureCode(CatalogFilterVO filter) {
Session session = sessionFactory.getCurrentSession();
CriteriaBuilder cb = session.getCriteriaBuilder();
CriteriaQuery<MasterProduct> query = cb.createQuery(MasterProduct.class);
Root<MasterProduct> mp = query.from(MasterProduct.class);
Join<MasterProduct, Product> p = mp.join("products");
// 动态 JOIN(需按白名单判断是否添加)
Join<MasterProduct, Nomenclature> n = null;
if (StringUtils.isNotEmpty(filter.getNomenclatureCode()) || getSortFieldLevel(filter.getSortField()) != 0) {
n = mp.join("nomenclature", JoinType.INNER);
}
// WHERE 条件(全部参数化)
List<pre class="brush:php;toolbar:false;"dicate> predicates = new ArrayList<>();
predicates.add(cb.equal(p.get("status"), filter.getProductStatus())); // 示例
if (StringUtils.isNotEmpty(filter.getTextSearch())) {
String likePattern = "%" + filter.getTextSearch() + "%";
predicates.add(cb.or(
cb.like(mp.get("partnerProductReference"), likePattern),
cb.like(mp.get("name"), likePattern)
));
}
query.select(cb.distinct(mp)).where(predicates.toArray(new Predicate[0]));
// ORDER BY(类型安全)
if (SORT_FIELD_TO_HQL.containsKey(filter.getSortField())) {
query.orderBy(cb.asc(mp.get(filter.getSortField()))); // 需映射到实体属性名
}
return session.createQuery(query).list();
}4. 其他关键注意事项
-
永远不要拼接表名、列名、HQL 关键字(如
ORDER BY,JOIN):这些属于“元数据”,必须来自预定义常量或白名单。 -
getSortOrder()必须大写校验:防止注入DESC, (SELECT ...). - 日志中避免打印完整 HQL:防止敏感逻辑泄露。
-
SonarQube 规则
java:S2077就是为此设计:修复后需在 Sonar 中验证该告警消失。
✅ 总结:HQL 注入 ≠ 参数未绑定,而是 HQL 结构本身被污染。安全的核心是——将用户输入严格限制为“值”(用
setParameter),而非“结构”(禁止拼接字段名、关键字、排序逻辑)。白名单 + Criteria API 是企业级应用的最佳实践。

















