首页 / 帮助文档 / 防止SQL注入开发阶段安全代码评审

防止SQL注入开发阶段安全代码评审

防止SQL注入从来不是上线前才要考虑的事情,真正有效的防线必须前置到开发阶段。代码评审是这道防线中最关键的一环,因为一旦带病代码进入测试或生产环境,修复成本会成倍增加,而且部分注入漏洞在常规功能测试中很难被触发。开发阶段的安全代码评审,核心目标就是在数据流向数据库之前,确认每一处SQL语句的构造方式是否安全、参数是否可控、权限是否最小化。

SQL注入的本质是用户输入被当作SQL代码的一部分执行。评审时最直接的判断标准就是:SQL语句中是否出现了字符串拼接用户输入的写法。无论是Java中的“+”、PHP中的“.”,还是C#中的“+”,只要用户可控的变量直接嵌入SQL字符串,就应当判定为高危问题。评审人员不需要纠结这个变量是否经过前端校验,因为前端校验可以被绕过,唯一可靠的是后端在SQL执行层面的处理方式。

参数化查询是必须强制执行的底线

参数化查询是目前公认最有效的防注入手段。它的原理是将SQL语句结构与数据分离,数据库驱动会把参数值当作纯数据处理,不会解析其中的SQL关键字或语法。评审代码时,应确认所有涉及用户输入的SQL操作都使用了PreparedStatement、SqlCommand参数、PDO预处理等方式。

以Java为例,安全的写法应当类似下面这样:

String customerName = request.getParameter("customerName");
String query = "SELECT account_balance FROM user_data WHERE user_name = ?";
PreparedStatement pstmt = connection.prepareStatement(query);
pstmt.setString(1, customerName);
ResultSet results = pstmt.executeQuery();

而下面这种写法必须被评审为不通过:

String customerName = request.getParameter("customerName");
String query = "SELECT * FROM users WHERE name = '" + customerName + "'";
Statement stmt = connection.createStatement();
ResultSet rs = stmt.executeQuery(query);

评审时还需要注意一个常见误区:有些开发人员认为存储过程天然免疫SQL注入,这是错误的。如果存储过程内部使用了EXEC或sp_executesql拼接字符串,同样存在注入风险。评审存储过程时,要检查其内部是否对参数进行了拼接执行。

动态SQL场景的评审重点

实际业务中,排序字段、表名、列名、分组条件等往往需要动态拼接,这些场景无法直接使用参数占位符,因为参数化查询不支持对SQL标识符的绑定。评审这类代码时,不能简单放过,必须确认开发人员是否使用了白名单校验。

白名单校验的做法是:预先定义允许的字段集合,将用户输入与集合进行匹配,只有匹配成功才允许拼入SQL。例如用户传入的排序字段,应当与后端定义的枚举或常量映射表进行比对,而不是直接接收任意字符串。评审时如果发现类似“order by ”后面直接跟用户输入,且没有白名单限制,就应判定为注入风险。

对于表名和列名,另一种可行方案是使用数据库提供的转义函数,但转义函数在不同数据库中的行为不一致,且容易遗漏,因此白名单仍然是首选。评审人员需要关注的是,白名单是否覆盖了所有可能的输入值,以及默认分支是否安全。

ORM框架并不能自动免疫注入

很多项目使用Hibernate、MyBatis、Entity Framework等ORM框架,部分开发人员误以为使用ORM就不会有SQL注入。实际上,ORM中的原生SQL或动态查询接口依然可能拼接用户输入。评审时需要重点检查MyBatis映射文件中的“${}”用法。

在MyBatis中,“#{}”是预编译占位符,安全;“${}”是字符串替换,不安全。只要映射文件中出现了“${}”并且其值来源于用户输入,就应判定为高危。例如:

SELECT * FROM users WHERE name = '${userName}'

这种写法等同于字符串拼接。评审时应要求开发人员改为“#{}”,如果确实需要动态表名或列名,则必须配合白名单校验。

Hibernate的HQL和Criteria查询本身对参数绑定支持较好,但createQuery或createSQLQuery中如果直接拼接用户输入,同样存在风险。评审时不能因为框架本身安全就放松对代码逻辑的检查。

输入验证与输出编码的边界

输入验证是纵深防御的一部分,但不能作为防注入的主要手段。评审时应当明确:输入验证可以降低风险,但不能替代参数化查询。开发人员不能以“已经做了长度限制”“已经过滤了单引号”为由拒绝使用参数化查询。

常见的错误做法包括:使用replace函数去除单引号、过滤SELECT或UNION等关键字、对输入进行HTML编码后存入数据库。这些方法要么可以被绕过,要么会影响数据的正常存储。评审时发现这类代码,应要求改为参数化查询,而不是继续强化过滤规则。

输出编码主要针对XSS,与SQL注入关系不大,但评审时需要防止开发人员混淆两者的处理方式。将输出编码函数用于SQL参数处理是无效的,反之亦然。

权限最小化与数据库账户配置

代码评审不仅要看SQL语句的构造方式,还要关注应用连接数据库所使用的账户权限。如果应用账户拥有数据库管理员权限,即使单条SQL语句安全,一旦出现其他漏洞(如命令执行、任意文件读取),攻击者可能直接通过数据库账户扩大影响。

评审时应确认应用数据库账户是否只具备执行必要DML操作的权限,是否禁用了DROP、CREATE、ALTER等DDL权限,是否对敏感表进行了单独的访问控制。对于查询类接口,应确认是否使用了只读账户。权限最小化不能阻止注入发生,但能显著降低注入成功后的破坏程度。

错误处理与信息泄露

SQL注入攻击往往依赖数据库报错信息来推断表结构、列名和数据类型。评审时需要检查代码中是否对数据库异常进行了统一处理,是否将原始数据库错误信息直接返回给前端。

安全的做法是:捕获SQLException或其他数据库异常后,记录详细日志到服务端,向用户返回通用的错误提示。评审时如果发现catch块中直接输出e.getMessage(),或者将异常堆栈打印到响应中,就应判定为信息泄露风险。这类问题虽然不是注入本身,但会大幅降低注入攻击的难度。

此外,评审还应关注日志中是否记录了完整的SQL语句和参数。如果日志中记录了敏感数据,需要确认日志的访问权限和脱敏策略,避免二次泄露。

二次注入与存储型注入

有些开发人员认为只要写入数据库时使用了参数化查询,后续读取时就不会有问题。实际上,二次注入的触发点在于读取后的再次使用。攻击者第一次请求时将恶意SQL片段作为数据存入数据库,参数化查询会将其作为普通数据处理,所以写入是安全的。但如果后续某个功能在读取该数据后,又将其拼接到新的SQL语句中执行,就会触发注入。

评审时需要追踪数据的完整生命周期,特别是那些从数据库读取后再次参与SQL拼接的字段。例如用户昵称、地址、备注等字段,如果后续被用于动态查询条件或报表生成,就必须检查第二次使用时的处理方式。二次注入的隐蔽性很强,评审人员不能只关注写入点,还要关注读取后的使用点。

批量操作与复杂查询的评审

批量插入、批量更新、IN子句、多条件组合查询等场景,容易出现参数化查询使用不规范的情况。例如IN子句中,有些开发人员会将用户输入的列表直接拼接成“'a','b','c'”的形式,而不是使用动态参数占位符。

安全的做法是动态生成与列表长度一致的占位符,例如:

SELECT * FROM products WHERE category IN (?, ?, ?)

然后逐个绑定参数。评审时如果发现IN子句使用字符串拼接,即使拼接的是数字,也应要求修改。数字虽然不能直接闭合引号,但攻击者可以构造“1) OR 1=1 --”等payload,依然可能绕过逻辑。

多条件组合查询中,开发人员可能根据用户是否传入了某个条件来动态拼接WHERE子句。评审时要确认每个条件的值都通过参数绑定,条件字段本身如果动态变化,则需要白名单校验。

代码评审的检查清单化

为了提高评审效率和一致性,建议将SQL注入相关的检查项固化为清单。评审人员逐项核对,避免遗漏。核心检查项包括:是否使用参数化查询、是否存在字符串拼接用户输入、动态标识符是否有白名单、ORM中是否使用了不安全的替换语法、存储过程内部是否拼接执行、数据库账户权限是否最小化、异常信息是否泄露、二次使用点是否安全、批量操作是否规范、日志是否脱敏。

评审过程中,对于任何不确定的写法,应要求开发人员提供安全说明或修改代码,而不是依赖口头保证。安全代码评审的结论应当明确:通过、有条件通过、不通过。有条件通过的情况必须列出整改项和期限。

开发阶段的安全代码评审不是一次性的活动,而应嵌入到每次代码合并或提交的流程中。对于新引入的数据库访问代码,应作为重点评审对象。对于历史代码,可以结合静态扫描工具进行批量筛查,但工具不能替代人工判断,尤其是涉及业务逻辑的二次注入和动态标识符场景。

真正有效的防注入体系,是让开发人员在编写代码时就具备安全意识,让评审人员在审查代码时有明确的判断标准,让每一行SQL都在进入生产环境前经过严格的参数化处理确认。这个过程没有捷径,但每一步都值得认真执行。