很多人以为用了ORM框架就自动免疫SQL注入,这其实是一个危险的误解。ORM只能减少手写SQL的概率,并不能根除拼接字符串带来的注入风险。真正的问题在于开发者如何使用ORM提供的查询构造器、原生SQL接口以及动态条件拼接。绝大多数ORM注入漏洞都出现在原生查询、字段名或排序参数直接拼接、以及不当使用模板字符串的场景中。要安全使用ORM,核心原则只有一条:所有用户输入都必须通过参数绑定进入SQL语句,而不是字符串拼接。
以常见的Python SQLAlchemy为例,最容易被忽视的注入点是"order_by"、"group_by"和"table"、"column"这类无法直接使用绑定参数的语法位置。比如下面这段代码就存在注入风险:
sort_field = request.args.get('sort')
query = db.session.query(User).order_by(sort_field)
攻击者可以传入"id desc; drop table users;--"这样的值,虽然不同数据库对多语句执行的支持不同,但即便不能执行多条语句,攻击者依然可以利用"case when"或时间盲注来窃取数据。正确的做法是使用白名单映射,把用户传入的字段名映射到模型的实际字段:
ALLOWED_SORTS = {
'id': User.id,
'username': User.username,
'created_at': User.created_at
}
sort_field = request.args.get('sort', 'id')
sort_column = ALLOWED_SORTS.get(sort_field, User.id)
query = db.session.query(User).order_by(sort_column)
另一个高频风险点是ORM的原生SQL接口。几乎所有主流ORM都提供了"raw"、"execute"或"text"这类方法,允许开发者直接编写SQL。如果在这类接口中使用f-string或百分号格式化拼接用户输入,注入就不可避免。例如SQLAlchemy中的错误写法:
username = request.form['username']
result = db.session.execute(
text(f"SELECT * FROM users WHERE username = '{username}'")
)
正确做法是使用命名参数或位置参数,让数据库驱动完成转义和绑定:
username = request.form['username']
result = db.session.execute(
text("SELECT * FROM users WHERE username = :username"),
{"username": username}
)
Django ORM的情况略有不同。Django的QuerySet API本身对字段名和值做了严格的分离,"filter"、"exclude"等方法默认使用参数绑定,因此直接使用"filter(username=username)"是安全的。但Django同样提供了"extra"、"raw"和"RawSQL"这些可以绕过ORM安全机制的接口。"extra"方法允许传入原始SQL片段,如果其中拼接了用户输入,就会产生注入。例如:
username = request.GET.get('username')
users = User.objects.extra(
where=[f"username = '{username}'"]
)
这段代码和直接拼接SQL没有本质区别。Django官方文档已经明确建议尽量避免使用"extra",而是用"annotate"配合"RawSQL"或直接使用"extra"的"params"参数。如果确实需要复杂条件,应该这样写:
username = request.GET.get('username')
users = User.objects.extra(
where=["username = %s"],
params=[username]
)
在Node.js生态中,Sequelize和TypeORM是使用最广泛的两个ORM。Sequelize的"findAll"、"findOne"等方法在"where"条件中使用对象形式时是安全的,因为底层会转换为参数绑定。但Sequelize的"order"、"group"、"attributes"等参数同样存在字段名拼接风险。特别是"order"参数,如果直接传入字符串数组,Sequelize会将其作为原始SQL片段处理:
const sort = req.query.sort;
await User.findAll({
order: [[sort, 'ASC']]
});
攻击者可以传入"id; DROP TABLE users;--"这样的内容。安全做法是维护一个允许排序的字段列表,并验证用户输入是否在其中:
const allowedSorts = ['id', 'username', 'email', 'createdAt'];
const sort = req.query.sort || 'id';
if (!allowedSorts.includes(sort)) {
throw new Error('Invalid sort field');
}
await User.findAll({
order: [[sort, 'ASC']]
});
TypeORM的QueryBuilder同样需要警惕。TypeORM提供了"createQueryBuilder"方法,开发者可以在"where"、"orderBy"、"groupBy"等方法中传入字符串。"where"方法支持两种形式:一种是使用"where("user.name = :name", { name: name })"的参数绑定形式,这是安全的;另一种是直接传入拼接好的字符串,这是危险的。很多开发者在动态构建查询条件时,习惯用数组拼接再"join",这很容易引入注入。例如:
const conditions = [];
if (username) {
conditions.push(`user.username = '${username}'`);
}
if (email) {
conditions.push(`user.email = '${email}'`);
}
const query = userRepo.createQueryBuilder('user');
if (conditions.length) {
query.where(conditions.join(' AND '));
}
这段代码中,"username"和"email"都直接拼进了SQL字符串。正确做法是使用TypeORM的条件参数绑定:
const query = userRepo.createQueryBuilder('user');
if (username) {
query.andWhere('user.username = :username', { username });
}
if (email) {
query.andWhere('user.email = :email', { email });
}
除了查询构造器和原生SQL,ORM的批量操作接口也值得关注。很多ORM提供了"insert"、"update"的批量方法,这些方法在内部处理上可能不如单条操作严格。例如Sequelize的"bulkCreate"方法,如果传入的对象中包含带有函数或特殊构造器的值,在某些旧版本中可能触发原型污染或SQL注入。虽然这类漏洞通常需要特定版本和配置才会触发,但作为开发者,应该保持ORM版本更新,并避免将不可信数据直接传入批量操作。
另一个常被忽略的注入面是ORM的"like"查询。很多开发者会这样写:
search = request.args.get('search')
users = User.query.filter(User.username.like(f'%{search}%')).all()
虽然SQLAlchemy的"like"方法本身使用绑定参数,但用户输入中的"%"和"_"通配符没有被转义,攻击者可以传入"%"来匹配所有记录,或者利用"_"来枚举数据。这虽然不是传统意义上的SQL注入,但属于查询逻辑被操纵。如果业务上需要用户输入的内容作为字面量进行模糊匹配,应该对通配符进行转义:
search = request.args.get('search', '')
escaped_search = search.replace('\\', '\\\\').replace('%', '\\%').replace('_', '\\_')
users = User.query.filter(User.username.like(f'%{escaped_search}%')).all()
在Java生态中,MyBatis和Hibernate是两大主流ORM。MyBatis的"#{}"和"${}"区别是安全使用的关键。"#{}"会被转换为预编译语句的参数占位符,而"${}"则是直接字符串替换。很多开发者在需要动态表名、列名或排序字段时使用"${}",这就打开了注入大门。例如:
如果"sortField"来自前端,攻击者可以注入任意SQL片段。即使业务确实需要动态字段,也应该在Java代码层做白名单校验,将合法字段映射为枚举或常量,再传入MyBatis。Hibernate的HQL同样如此,HQL支持命名参数,使用"setParameter"方法是安全的,但字符串拼接HQL则不安全。Hibernate 5及以上版本对HQL的解析更加严格,但仍然不能依赖框架本身来阻止所有注入。
还有一个容易被忽视的细节是ORM的日志和错误处理。当SQL执行出错时,ORM可能会把包含部分SQL语句的错误信息返回给前端。攻击者可以利用这些错误信息推断数据库结构,甚至通过报错注入获取数据。因此,生产环境应该关闭ORM的详细SQL日志输出,并统一处理异常,避免将数据库错误细节暴露给用户。
从防御体系的角度看,安全使用ORM不能只靠开发者的小心翼翼。团队应该在代码审查中重点检查所有原生SQL接口、动态字段名拼接、以及"order_by"、"group_by"等特殊语法位置。同时,可以在CI流程中引入静态代码扫描工具,检测常见的ORM不安全用法。例如针对Python项目,可以配置Bandit或Semgrep规则,识别"text(f"...{...}")"这类模式;针对Java项目,可以检测MyBatis XML中的"${}"使用。这些自动化检查虽然不能覆盖所有场景,但能显著降低人为疏忽带来的风险。
ORM框架本身也在不断进化。现代ORM越来越倾向于提供类型安全的查询构建器,从API设计上减少字符串拼接的机会。例如SQLAlchemy 2.0的Select API、TypeORM的QueryBuilder链式调用、以及Prisma的类型安全查询,都在引导开发者使用结构化参数而不是字符串片段。但无论框架如何演进,开发者对SQL注入基本原理的理解始终是最后一道防线。只要记住“用户输入永远不可信”和“参数绑定优先于字符串拼接”这两条原则,绝大多数ORM注入风险都可以避免。
在实际项目中,建议为ORM查询建立统一的封装层,将字段白名单、排序规则、分页参数等常见操作集中管理。例如在Django项目中,可以编写一个通用的排序解析函数,只接受模型中实际存在的字段名,并自动映射到对应的ORM表达式。在Node.js项目中,可以封装一个查询参数校验中间件,统一处理"sort"、"order"、"limit"、"offset"等参数。这样既能减少重复代码,也能从架构层面降低注入风险。安全不是某个点的修补,而是贯穿整个开发流程的持续实践。
