RawSQL的params仅替换占位符,不防护字符串拼接;f-string或format提前拼接会使参数化失效,LIKE需手动转义通配符,函数名/字段名等结构部分须白名单校验,优先用ORM表达式替代。

RawSQL的params只替换占位符,不防护字符串拼接
很多人以为写了params=[...]就万事大吉,但RawSQL本身是表达式对象,不是查询语句。它只在最终 SQL 渲染时把params里的值填进%s位置,而模板字符串如果已经用f-string或.format()拼好了,参数化就完全失效了。
- ❌ 错误:攻击者输入
search = "admin' OR 1=1 --",f"LIKE '%{search}%'"在Python层就生成了危险SQL片段 - ✅ 正确:把整个
LIKE模式作为参数传入,让数据库驱动处理转义 - ⚠️ 注意:
%和_在LIKE中是通配符,必须手动包裹或转义,不能依赖用户输入原样塞进去
LIKE场景必须用prep_for_like_query()或手动加通配符
直接写RawSQL("title LIKE %s", params=["%"+search+"%"])看似安全,但若search含%或_,会意外匹配大量行甚至拖垮查询。Django提供connection.ops.prep_for_like_query()做标准转义,比手写更可靠。
- ✅ 推荐写法:
from django.db import connection;escaped = connection.ops.prep_for_like_query(search);RawSQL("title LIKE %s", params=[f"%{escaped}%"]) - ❌ 避免:
RawSQL(f"title LIKE '%{search}%'", params=[...])——f-string提前拼接,params根本没机会生效 - ? 小技巧:如果只是模糊匹配,优先用
title__icontains=search,ORM自动处理转义和索引友好
RawSQL + annotate()时字段名/函数名仍需白名单校验
params只管“值”,不管“结构”。你在RawSQL里写的CASE WHEN、CONCAT、COALESCE这些函数名,或者引用的字段如user_id、status_code,都得确保来自可信来源。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能,主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该
- ❌ 危险:
func = request.GET.get("func"); RawSQL(f"{func}(title)")——攻击者传UPPER没事,传PG_SLEEP(10)就暴露数据库延迟 - ✅ 安全:
if func not in ["UPPER", "LOWER", "LENGTH"]: raise ValueError("Invalid function"),再拼进RawSQL - ⚠️ 同理:动态表别名、JSON路径(如
data->>'name')、窗口函数OVER(PARTITION BY ...)中的字段,都得进白名单
比RawSQL更安全的替代方案优先级
RawSQL是最后手段。Django 4.2的ORM表达式能力足够强,多数场景能避开原生SQL,也自然避开注入风险。
- ✅ 模糊搜索:
Case(When(title__icontains=search, then=1), default=0, output_field=IntegerField()) - ✅ 条件计算:
Value(1, output_field=IntegerField()) if condition else Value(0),或用Q组合 - ✅ 字符串拼接:
Concat('first_name', Value(' '), 'last_name'),比CONCAT(first_name, ' ', last_name)更安全 - ? 记住:只要没出现
%s、没调RawSQL、没碰cursor.execute(),你就还在ORM的安全通道里
实际项目里最常翻车的,不是params写错,而是把RawSQL当成“可以随便写SQL的快捷方式”,忘了它和cursor.execute()一样,需要你对整条SQL的结构负全责。










