所有原始查询接口(sequelize.query、Prisma.$queryRawUnsafe、TypeORM.query、Knex.raw)均不自动防护SQL注入,用户可控的标识符必须白名单校验,值参数须用占位符绑定,绝不可模板字符串拼接。

sequelize.query() 里拼字符串就是裸奔
很多人以为用了 Sequelize 就安全了,结果在 sequelize.query() 里用模板字符串拼接 req.query.sort 或 req.body.tableName,等于把数据库大门钥匙直接塞给攻击者。这种写法绕过了 ORM 的所有参数化机制,驱动层收到的就是完整恶意 SQL。
常见错误现象:
- 请求
?sort=createdAt%20DESC,username%20ASC看似无害,但若后端拼成ORDER BY ${sort},攻击者可改为createdAt DESC, (SELECT password FROM users LIMIT 1) - 报错信息暴露表结构,比如
Unknown column 'xxx' in 'order clause',帮攻击者反推字段名
实操建议:
- 永远不用
${...}拼接任何用户可控的 SQL 片段(包括ORDER BY、GROUP BY、FROM) - 排序字段必须白名单校验:
['id', 'createdAt', 'status'],不在列表中直接拒掉 - 表名/列名这类标识符无法参数化,只能靠严格枚举或正则过滤(如
/^[a-zA-Z_][a-zA-Z0-9_]*$/)
Prisma $queryRawUnsafe 的命名已经预警了风险
$queryRawUnsafe 这个名字不是玩笑——它明确告诉你:这里不安全。但很多团队把它当普通 API 用,把 req.query.search 直接插进 WHERE name LIKE '%${search}%',等同于手动关闭所有防护。
使用场景:
- 需要窗口函数、CTE、JSON 函数等 ORM 不支持的语法
- 跨 schema 查询或动态分区表路由
实操建议:
- 只要值参与查询逻辑,一律改用
$queryRaw+ 占位符:Prisma.sql`SELECT * FROM users WHERE name ILIKE ${`%${search}%`}` - 避免在
$queryRawUnsafe中出现任何${...},哪怕你“确认过输入是数字”——类型校验可能被绕过 - 上线前 grep 全项目
$queryRawUnsafe,逐行人工审计
TypeORM query() 中的 parameters 参数常被忽略
TypeORM 的 query() 方法支持 parameters 数组,但开发者常只传 SQL 字符串,把变量硬塞进模板里。例如 await query(`SELECT * FROM ${tableName} WHERE id = ${id}`),哪怕 id 是数字,也可能被 id=1; DROP TABLE users-- 注入。
参数差异:
-
parameters: []→ 值被自动转义并绑定,安全 - 没传
parameters或传空数组 → 字符串原样执行,不安全
实操建议:
- 强制要求所有
query()调用都带非空parameters,哪怕只是占位[1] - 动态表名/列名必须提前映射为固定字符串:
const tableMap = { user: 'users', order: 'orders' },再取tableMap[req.query.type] - 注意
parameters是按顺序绑定的,不要混用命名参数和位置参数
Knex.raw() 的 bindings 不等于安全
Knex.raw() 支持 bindings 参数,但很多人误以为只要用了它就万事大吉。问题在于:bindings 只保护值,不保护 SQL 结构。如果 raw('SELECT * FROM ?? WHERE status = ?', [tableName, status]) 中 tableName 来自用户输入,?? 会原样代入,而 Knex 对 ?? 的校验极弱,基本等于没防。
性能 / 兼容性影响:
- 用
??或???做标识符替换时,Knex 内部只是简单加反引号,不校验是否合法标识符 - PostgreSQL 下表名含小数点或特殊字符时,
??会失效,导致语法错误而非拦截
实操建议:
-
??只用于开发期已知的固定标识符,绝不用在运行时动态字段上 - 用户可控的标识符必须走白名单:
if (!['users', 'products'].includes(tableName)) throw new Error('Invalid table') - 复杂场景改用 Knex 的
ref()+wrapIdentifier钩子做统一拦截
最易被忽略的一点:ORM 的“安全默认”只覆盖它自己生成的查询路径;一旦你显式调用原始查询接口,那条路就完全由你负责——没有自动转义,没有隐式绑定,也没有运行时告警。每处 query()、raw()、$queryRawUnsafe 都得当成独立 SQL 注入入口来设计防御。

















