讲师中心 微信公众号
AI工具推荐 视频效率加速

如何使用Sequelize参数绑定防止SQL注入

夜涛酱_7667

夜涛酱_7667

发布时间:2026-08-24 13:40:44

|

842人浏览过

|

来源于php中文网

原创

Sequelize模型方法默认参数化,但用户输入若用于列名、表名、排序字段等SQL结构位则仍危险;sequelize.query()需显式使用replacements;literal()和fn()遇用户输入即失效;动态字段必须通过硬编码白名单校验。

如何使用sequelize参数绑定防止sql注入

Sequelize.findAll() 等模型方法默认就参数化,不用额外配置

只要用 Model.findAll()、Model.findOne()、Model.update()、Model.destroy() 这类标准方法,且所有用户输入都放在 where、attributes(值部分)、limit、offset 等“数据位置”,Sequelize 就会自动走预编译 + 参数绑定。不需要手动加 replacements 或转义。

常见错误是误以为“用了 ORM 就万事大吉”,结果把用户输入塞进 SQL 结构位:比如 where: { [req.query.field]: req.query.value } —— 方括号动态键名会让 req.query.field 变成裸列名,直接拼进 SQL;又比如 order: [[req.query.sortBy, 'DESC']] —— 排序字段无法参数化,一传就破防。

  • where: { email: req.query.email } ✅ 安全:值被绑定为 ? 参数
  • where: { [req.query.col]: 'value' } ❌ 危险:列名被当 JS 属性解析,最终生成 WHERE user_input = 'value'
  • attributes: ['id', req.query.include] ❌ 危险:数组元素若为用户输入,会被当列名直插

sequelize.query() 必须显式用 replacements,不能字符串拼接

sequelize.query() 不像模型方法那样“开箱即用”,它默认不参数化。如果你写 sequelize.query(`SELECT * FROM users WHERE id = ${req.query.id}`),等于裸奔。

正确做法是用 replacements 选项,且只接受数组或对象形式的占位符:

  • sequelize.query('SELECT * FROM users WHERE status = ?', { replacements: ['active'] })
  • sequelize.query('SELECT * FROM users WHERE id IN (:ids)', { replacements: { ids: [1, 2, 3] } })

注意:replacements 只处理“值”,不处理表名、列名、函数名。所以 SELECT * FROM ${req.query.table} 即使加了 replacements 也无效 —— 那里根本不是参数位。

literal() 和 fn() 是注入高危区,含用户输入就等于放弃防御

Sequelize.literal() 的设计目标就是“原样输出”,它绕过所有参数机制。只要里面出现 req.*、模板字符串、+ 拼接,就立刻失效。

  • where: { name: { [Op.like]: literal(`%${req.query.q}%`) } } ❌ 破防:拼接后变成 name LIKE '%admin'-- %'
  • attributes: [[literal('NOW()'), 'ts']] ✅ 安全:字符串完全静态,无变量
  • fn('LOWER', literal(req.query.q)) ❌ 危险:literal() 包裹什么,就输出什么,函数不改变其本质

同理,fn() 本身不危险,但一旦它的参数是 literal() 或动态字符串,就等价于手写 SQL 片段 —— 而这不是 ORM 该干的事。

白名单校验必须落在 Controller,不能靠正则或数据库读取

排序字段、分组字段、动态列名这些无法参数化的位置,唯一靠谱的方案是硬编码白名单,在路由处理层做校验。

例如允许按 id、name、created_at 排序:

  • 定义 const ALLOWED_SORT_FIELDS = ['id', 'name', 'created_at'](写死在代码里)
  • 取值前判断:const sortField = ALLOWED_SORT_FIELDS.includes(req.query.sort) ? req.query.sort : 'id'
  • 再传入:order: [[sortField, 'ASC']]

别用 req.query.sort.replace(/[^a-z_]/g, '') 这类“过滤”——攻击者早就能用 Unicode、大小写混用、反斜杠绕过;也别从数据库查出字段列表动态生成白名单——表结构可能变,且查询本身可能被注入影响结果。

真正难的不是写对那几行代码,而是每次加新功能时,都得问一句:“这个变量,最后会出现在 SQL 的结构位,还是纯值位?” 问错一次,前面所有参数化都白搭。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

3783

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

811

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

989

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

5581

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2563

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

5580

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

7301

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

990

2024.04.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP开发基础之数据库篇(PDO)
PHP开发基础之数据库篇(PDO)

共10课时 | 2.2万人学习

魔乐科技oracle视频教程
魔乐科技oracle视频教程

共27课时 | 6.6万人学习

PHP开发基础之数据库篇(PDO)
PHP开发基础之数据库篇(PDO)

共10课时 | 2.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn