Prisma本身不自动防SQL注入,仅当使用findMany等声明式API且用户输入仅作为值传入where/data时才安全;动态表名、字段名须白名单校验,$queryRawUnsafe绝对禁用。

Prisma 在 Next.js 14 全栈项目中本身不自动防 SQL 注入——安全与否,完全取决于你调用它的姿势。只要坚持用 findMany、update 等声明式方法传用户输入进 where 或 data,就天然免疫;一旦碰 $queryRawUnsafe 或在模板字符串里插表名/字段名,防线立刻崩溃。
Prisma 声明式 API(如 findMany)为什么默认安全
Next.js 服务端组件或 Route Handler 中调用 prisma.user.findMany({ where: { id: parseInt(req.query.id) } }) 是安全的,因为 Prisma 客户端底层把整个查询编译成参数化语句,数据库只接收预编译骨架 + 绑定值。即使 req.query.id 是 "1 OR 1=1 --",最终送进去的也只是字符串字面量 "1 OR 1=1 --",不会触发语法解析。
常见错误现象:
- 手动拼接
where对象:比如{ [dynamicKey]: value }且dynamicKey来自用户输入 - 对
parseInt()结果不做范围校验,导致负数或极大值绕过业务逻辑(虽不直接导致注入,但可能引发其他漏洞)
实操建议:
- 所有用户输入必须作为值传入
where/data/select等对象内部,绝不拼 key 名 - 数字类参数务必用
parseInt()或Number()转型,并配合isNaN()和范围检查(如id > 0 && id ) - 字符串搜索慎用
contains:若需模糊匹配,确保前端已过滤掉%、_等通配符,或后端用prisma.$queryRaw配合ILIKE+ 参数化
$queryRaw 是唯一可安全使用原生 SQL 的入口
$queryRaw 本身不危险,真正起作用的是它配合 Prisma.sql 模板字面量实现的参数绑定机制。例如:prisma.$queryRaw`SELECT * FROM users WHERE email = ${email} AND status = ${'active'}` 是安全的;而 prisma.$queryRaw`SELECT * FROM ${tableName}` 则绝对不合法。
容易踩的坑:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
- 误以为
${parseInt(x)}就万事大吉——如果x是"1.0"或"1e2",某些驱动仍可能接受,应强制Math.floor(Number(x))并校验整数性 - 在
ORDER BY、GROUP BY、LIMIT位置用${}插值:这些是 SQL 结构,不是值,数据库不允许参数化 - 把
$queryRaw当作$queryRawUnsafe的“加盐版”,试图靠转义字符糊弄过去
实操建议:
-
ORDER BY字段必须白名单硬编码:const allowedSort = ['name', 'createdAt']; const sort = allowedSort.includes(req.query.sort) ? req.query.sort : 'createdAt'; -
LIMIT值只接受数字,并限流:const limit = Math.min(Math.max(1, parseInt(req.query.limit) || 10), 100); - 复杂聚合或窗口函数必须走
$queryRaw+Prisma.sql,且所有用户数据仅出现在${}内部
$queryRawUnsafe 是红线,永远不要用于任何用户输入
$queryRawUnsafe 不做任何解析、不转义、不参数化,传什么就执行什么。哪怕只让它处理一个 req.query.id,攻击者也能塞入 "1; DROP TABLE users; --" 直接击穿。
典型错误场景:
- “只是查个配置表,应该没问题”——只要接口暴露给前端或第三方,就存在被批量探测风险
- “我用了正则过滤单引号”——PostgreSQL 支持 Unicode 引号、MySQL 支持反引号,绕过成本极低
- “我在本地开发环境测试过”——生产环境数据库权限、错误回显、驱动行为都可能不同
实操建议:
- 全局搜索项目代码,删掉所有
$queryRawUnsafe调用;如有遗留建表/迁移脚本,改用 Prisma Migrate 或单独 shell 脚本执行 - CI 流程中加入 ESLint 规则,禁止提交含
$queryRawUnsafe的代码 - 若真有不可替代的动态结构需求(如多租户切换 schema),用中间件在请求入口层做严格白名单路由,而非在数据库查询层拼接
最易被忽略的一点:Prisma 的安全模型只覆盖“值”的参数化,从不保护“结构”。表名、字段名、排序方向、分组维度、UNION 分支——这些全得靠硬编码白名单或 if/else 显式枚举。别指望 ORM 自动帮你兜底,也别信“输入过滤+类型转换”能替代结构校验。

















