Django执行复杂原生SQL报argument formats can't be mixed错误求助

核心原因及解决办法 #

• 占位符格式混用：Django的raw()方法不允许同时使用位置占位符（%s）和命名占位符（%(param)s）。检查你的SQL语句，所有参数必须统一用同一种格式：
  • 选位置占位符：SQL里全用%s，调用raw()时按顺序传参数列表；
  • 选命名占位符：SQL里全用%(xxx)s，调用时传参数字典。
• CTE内部占位符不一致：如果CTE子句里也有参数占位符，必须和主查询的占位符格式保持一致，不能CTE用命名、主查询用位置，反之亦然。
• 未转义的%符号：SQL里如果有%（比如模糊查询LIKE '%test%'），要写成%%，否则Django会把单个%识别成参数占位符，引发格式冲突。
• 参数传递不匹配：确认传参数量、顺序（位置参数）或键名（命名参数）和SQL里的占位符完全对应，少传、错传都可能触发错误。

调试步骤 #

1. 打印最终执行的SQL：通过print(main_query.raw_query)查看Django解析后的SQL语句，对比psql里能正常运行的版本，找差异。
2. 逐步简化排查：先去掉CTE，用简单SQL测试raw()是否正常；再逐步加回CTE部分，定位问题环节。
3. 检查隐藏占位符：比如SQL注释、字符串里的%没转义，会被Django误判为参数占位符。

示例修正 #

原错误SQL（混用占位符）：

WITH cte AS (
    SELECT id FROM table1 WHERE category_id = %(cat_id)s
)
SELECT * FROM table2 WHERE id = %s AND EXISTS (SELECT 1 FROM cte WHERE cte.id = table2.id)

修正为统一命名参数：

WITH cte AS (
    SELECT id FROM table1 WHERE category_id = %(cat_id)s
)
SELECT * FROM table2 WHERE id = %(table2_id)s AND EXISTS (SELECT 1 FROM cte WHERE cte.id = table2.id)

调用方式：

main_query = YourModel.objects.raw(sql, {'cat_id': 1, 'table2_id': 2})

或者统一位置参数：

WITH cte AS (
    SELECT id FROM table1 WHERE category_id = %s
)
SELECT * FROM table2 WHERE id = %s AND EXISTS (SELECT 1 FROM cte WHERE cte.id = table2.id)

调用方式：

main_query = YourModel.objects.raw(sql, [1, 2])

内容的提问来源于stack exchange，提问作者higherbit