Filter()仅支持AND逻辑,OR、NOT或嵌套条件必须用Raw();Raw()需用?占位符防注入,LIKE的%要拼在参数中;混合条件应先Filter构建AND部分,再用Raw查ID列表后通过id__in合并。

Filter() 只能做 AND,OR 必须用 Raw()
Beego ORM 的 Filter() 方法每次调用都追加一个 WHERE 子句,且默认是 AND 连接。它不支持 OR、括号分组或混合逻辑。比如想查 name__icontains="a" OR title__icontains="a",Filter() 完全无法表达。
常见错误是试图拼接多个 Filter() 模拟 OR:qs.Filter("name__icontains", kw).Filter("title__icontains", kw) —— 这实际生成的是 WHERE name LIKE ? AND title LIKE ?,语义完全相反。
- 只要出现
OR、NOT、嵌套条件(如(A AND B) OR C),就必须放弃Filter(),改用Raw() -
Raw()是唯一可控 SQL 逻辑的方式,但必须用占位符传参,禁止字符串拼接 - 如果仍需返回结构体(而非原始 map),可先用
Raw()查 ID 列表,再用Filter("id__in", idList)二次加载
Raw() 中正确写 OR 条件的姿势
直接写原生 SQL 时,字段名、表名要和数据库一致(注意大小写),参数必须用 ? 占位,由 Beego 自动绑定,避免 SQL 注入。
错误示例:o.Raw("SELECT * FROM post WHERE name LIKE '%" + kw + "%' OR title LIKE '%" + kw + "%'") ❌ —— 用户输入未转义,极易被注入。
正确写法:
o.Raw("SELECT * FROM post WHERE name LIKE ? OR title LIKE ?", "%"+kw+"%", "%"+kw+"%").QueryRows(&posts)
- LIKE 模式中的
%要手动拼到参数值里,不能写在 SQL 字符串中 - 多个
?占位符顺序必须和参数顺序严格一致 - 若查询字段较多或需关联,优先考虑
Raw("SELECT id FROM ...")得到 ID 切片,再走 ORM 加载完整对象,兼顾安全与类型安全
动态条件中混用 AND 和 OR 的典型场景
比如搜索接口:用户可选「状态」、「关键词」、「时间范围」,其中关键词要匹配 name 或 title(OR),其余都是 AND 关系。这时不能把所有条件塞进一个 Raw() 硬编码,而应拆解逻辑:
- 先收集所有 AND 条件(status、created__gte 等),用
Filter()链式构建基础QuerySeter - 若关键词非空,单独构造
Raw()子查询查出匹配的id列表 - 最后用
Filter("id__in", idList)和前面的QuerySeter合并:即qs.Filter("id__in", idList) - 这样既复用了 ORM 的类型映射和空值判断,又规避了手写复杂 SQL 的风险
容易被忽略的双下划线和字段名细节
哪怕只用 Filter() 做纯 AND 查询,字段表达式写错也会静默失败。例如:
-
Filter("name__icontains", "foo")正确;写成name_icontains(单下划线)或name__contains(少 i)会查不到数据,也不报错 - 外键字段要用双下划线连接:
profile__age__gt,不是Profile.Age__gt或profile_age__gt - 字段名区分大小写:数据库列是
user_name,结构体 tag 是orm:"column(user_name)",那Filter("user_name", ...)才有效;写成UserName就失效
AND 和 OR 的边界很清晰:凡涉及 OR,立刻切到 Raw();凡用 Filter(),务必核对双下划线语法和字段真实名称,否则条件就丢了。











