防止SQL注入的关键不是抛弃ORM,而是正确使用参数化查询与安全API,避免将用户输入拼接进SQL或ORM原生语句。ORM框架本身能显著降低注入风险,但误用字符串拼接、原生SQL或动态排序等写法仍会造成高危漏洞。本文给出可落地的ORM安全使用规范、代码示例与检查清单。

ORM为何不能完全杜绝SQL注入

ORM(对象关系映射)框架通过实体映射和查询构造器将数据库操作抽象为对象方法,默认的增删改查通常会自动使用预编译语句和参数绑定。但根据OWASP 2023年统计数据,SQL注入仍位列Web应用安全风险前三,其中相当比例漏洞出现在使用了ORM的项目中。原因在于ORM提供原生SQL接口、动态查询片段拼接和字符串模板等灵活能力,开发者一旦为了“方便”绕过参数化机制,就重新打开了注入入口。

例如在Python的SQLAlchemy中,session.execute(text("SELECT * FROM users WHERE name = '" + username + "'"))属于典型的字符串拼接注入。即使使用ORM,只要SQL语句由字符串运算符连接用户输入,数据库驱动就无法区分代码与数据,攻击者输入' OR '1'='1即可改变查询逻辑。因此,ORM安全的核心原则是:任何用户可控数据必须通过绑定参数传入,绝不进入SQL文本。

正确用法一:优先使用ORM查询构造器与实体API

主流ORM框架的查询构造器在生成SQL时会自动对条件值做参数化处理。以Java的JPA为例,使用JPQL命名参数是安全基线写法:

TypedQuery<User> query = entityManager.createQuery(
    "SELECT u FROM User u WHERE u.email = :email", User.class);
query.setParameter("email", userInput);
List<User> result = query.getResultList();

在.NET Entity Framework中,LINQ表达式会被翻译为参数化SQL,context.Users.Where(u => u.Email == userInput).ToList()不会将userInput直接嵌入SQL文本。同样,Python Django的User.objects.filter(email=user_input)、Ruby on Rails的User.where(email: user_input)均使用占位符绑定。开发规范中应明确禁止在查询构造器内使用字符串格式化、模板字面量或加号拼接用户输入。

对于动态条件组合,应使用框架提供的条件API而非手写SQL片段。例如MyBatis中避免${}而使用#{}:

<select id="findByEmail" resultType="User">
  SELECT * FROM users WHERE email = #{email}
</select>

#{}会被预编译为?占位符并由驱动安全传值,而${}是直接文本替换,属于高危写法。同理,Laravel的DB::table('users')->where('email', $email)安全,但DB::select("SELECT * FROM users WHERE email = '$email'")不安全。

正确用法二:原生SQL必须走参数绑定通道

当业务确实需要原生SQL(复杂报表、性能调优、数据库专有函数)时,必须调用ORM提供的参数绑定接口,而不是自行拼接。以SQLAlchemy为例,安全写法是使用text()配合命名参数:

from sqlalchemy import text
result = session.execute(
    text("SELECT * FROM users WHERE email = :email"),
    {"email": user_input}
)

在Spring JdbcTemplate中,应使用queryForList(String sql, Object... args)或NamedParameterJdbcTemplate,将用户输入作为独立参数传入。在Entity Framework中执行原生SQL时使用FromSqlRaw配合SqlParameter:

var emailParam = new SqlParameter("@email", userInput);
var users = context.Users.FromSqlRaw(
    "SELECT * FROM Users WHERE Email = @email", emailParam).ToList();

需要特别警惕的是ORM中形如executeQuery、raw、nativeQuery的接口。它们本身不是漏洞来源,但若开发者将拼接好的SQL字符串传入,就等同于裸用JDBC或PDO时的注入风险。代码审计时可将这些接口调用点列为重点检查对象,确认其SQL文本中不包含任何变量插值。

动态排序、分页与表名字段名的特殊处理

参数绑定只能保护“值”的位置,无法保护标识符(表名、列名、排序字段、排序方向)。若业务需要根据用户选择动态生成ORDER BY或GROUP BY,直接拼接字段名同样会形成注入。例如query += " ORDER BY " + sortField,攻击者可传入price; DROP TABLE users--。正确做法是使用白名单映射:

private static final Map<String, String> ALLOWED_SORT = Map.of(
    "created", "create_time",
    "price", "price",
    "sales", "sales_count"
);
String sortColumn = ALLOWED_SORT.getOrDefault(userSort, "create_time");
String sortDir = "desc".equalsIgnoreCase(userDir) ? "DESC" : "ASC";
query += " ORDER BY " + sortColumn + " " + sortDir;

分页参数同样需要校验为整数类型,并限制最大值。Django的Paginator、MyBatis-Plus的分页插件、Spring Data的Pageable都提供了类型安全的参数接收方式,应避免从请求中直接取字符串拼入LIMIT和OFFSET。表名动态场景可使用框架的元数据API或预定义枚举,禁止用户输入直接决定表名。

ORM配置与二次封装中的常见反模式

许多团队会在ORM之上封装通用查询工具类,但封装不当会破坏底层参数化机制。典型反模式包括:接收已拼接的SQL字符串、提供whereString参数直接附加条件、以及用String.format生成查询。例如某项目中出现的baseDao.find("FROM User WHERE name LIKE '%" + keyword + "%'"),即使底层ORM本身安全,封装层已引入注入漏洞。

另一个高频风险是模糊查询的LIKE拼接。安全写法应将通配符放入参数值而非SQL文本:

// 安全:通配符在参数中
List<User> users = session.createQuery(
    "FROM User WHERE name LIKE :keyword", User.class)
    .setParameter("keyword", "%" + userInput + "%")
    .getResultList();

如果写成"... LIKE '%" + userInput + "%'",则用户输入中的单引号可提前闭合字符串并注入额外条件。此外,ORM的日志和SQL打印功能在生产环境应关闭或脱敏,避免将带参数的完整SQL和敏感数据写入日志文件,形成二次泄露风险。

多层防御与安全验证实践

除正确使用ORM外,建议叠加以下措施形成纵深防御:在应用入口对输入做类型、长度和格式校验,拒绝明显异常的数据;数据库账号遵循最小权限原则,应用账号仅授予必要的SELECT、INSERT、UPDATE权限,不授予DDL和系统存储过程权限;部署Web应用防火墙(WAF)作为网络层拦截;定期使用静态代码扫描工具检查ORM调用点,例如SpotBugs、SonarQube的自定义规则可标记createQuery中的字符串拼接。

在测试阶段,可引入SQL注入自动化测试用例,覆盖常见载荷如' OR 1=1 --、'; WAITFOR DELAY '0:0:5'--、1; SELECT pg_sleep(5)等。根据Veracode 2024年报告,采用参数化查询后SQL注入漏洞修复率可达97%以上,而单纯依赖输入过滤的修复率不足60%。这说明从查询构造层面杜绝拼接才是根本解。

常见问题

使用ORM框架就完全不会SQL注入吗?

不是。ORM默认查询通常是安全的,但使用原生SQL接口、字符串拼接动态条件、动态排序字段或表名时,仍可能产生SQL注入漏洞。安全取决于是否始终采用参数绑定和白名单校验。

ORM中#{}和${}有什么区别?

在MyBatis等框架中,#{}表示预编译占位符,值由驱动安全绑定;${}是直接文本替换,会将内容原样拼入SQL。任何用户输入都应使用#{},${}仅可用于经过严格白名单校验的标识符。

动态排序字段如何防止SQL注入?

不能将用户传入的排序字段直接拼接进SQL。应建立允许排序字段的白名单映射表,将用户输入转换为预定义的列名,排序方向同样只接受ASC或DESC两个枚举值。

LIKE模糊查询怎样写才安全?

将通配符%或_放在参数值中,通过参数绑定传入。例如WHERE name LIKE :keyword,参数值为% + userInput + %。不要将通配符和用户输入直接拼接在SQL字符串里。

ORM原生SQL接口怎样避免注入?

调用原生SQL接口时必须使用框架提供的参数绑定能力,例如SQLAlchemy的text()加字典参数、Spring的NamedParameterJdbcTemplate、Entity Framework的SqlParameter。禁止将用户输入通过字符串连接或格式化函数嵌入SQL文本。