当前位置：首页 > 文章列表 > Golang > Go教程 > Go Squirrel 怎样用 Eq 安全构造可选查询条件

Go Squirrel 怎样用 Eq 安全构造可选查询条件

来源：17golang原创 2026-10-29 12:23:05 0浏览收藏

用 sq.Eq{"status": value} 为固定列名构造参数化条件，再根据参数是否提供，决定要不要调用 Where。关键是让列名由程序控制、用户值进入参数列表；不要把筛选值拼进 SQL 字符串，也不要把“没提供”误当成 false、0 或 SQL NULL。

官方地址：https://github.com/Masterminds/squirrel

Squirrel 的项目说明将其定位为已完成功能、仍接受修复的 SQL 构造器，本文解读这项已有能力，不把它包装成刚发布的新功能。适用场景是列表接口的可选筛选：状态、是否归档、负责人等参数可以分别省略。

先把可选值和SQL结构分开

传统拼接经常混合三个问题：决定条件是否出现、选择列名、表达参数值。Eq 负责后两者中的值表达，但 map 的键仍是 SQL 结构的一部分。列名必须来自代码或允许列表，不能直接把请求中的任意字段名塞进去。

多个 Where 条件通常以 AND 组合；Eq map 中多个键也构成 AND。构造器返回更新后的值，因此追加时写 query = query.Where(...)，而不是调用后丢弃返回结果。官方用法见 Squirrel 项目说明。

图中的 筛选参数、提供状态 属于请求信息；固定列名、Eq、Where、SelectBuilder 属于构造职责。是否提供决定追加与否，Eq 关联固定列名和筛选值，Where 将条件加入构造器。

可选参数与固定列名构造Eq条件的静态结构图 — 结构图：参数是否提供与条件表达分别处理，SQL列名保持由程序控制。连线表示依赖，不是执行步骤。

用指针区分未提供与零值

下面是完整的构造函数文件。它只返回 SQL 和 args，不执行数据库查询。Status=nil 表示不按状态筛选；指向空字符串则表示明确匹配空字符串。Archived 指向 false 时仍应产生条件。

package query

import (
    "fmt"

    sq "github.com/Masterminds/squirrel"
)

type TicketFilter struct {
    Status    *string
    Archived  *bool
    OwnerID   *int64
    OnlyUnassigned bool
}

func BuildTicketQuery(filter TicketFilter) (string, []interface{}, error) {
    // 互相矛盾的条件在应用层处理，不把组合解释留给数据库。
    if filter.OnlyUnassigned && filter.OwnerID != nil {
        return "", nil, fmt.Errorf("负责人和未分配条件不能同时指定")
    }

    query := sq.Select("id", "status", "archived", "owner_id").
        From("support_tickets").
        OrderBy("id DESC").
        Limit(100).
        PlaceholderFormat(sq.Dollar) // 本例使用 PostgreSQL 占位符。

    if filter.Status != nil {
        query = query.Where(sq.Eq{"status": *filter.Status})
    }
    if filter.Archived != nil {
        // false 也是有效筛选值，不能用 if *filter.Archived 代替。
        query = query.Where(sq.Eq{"archived": *filter.Archived})
    }
    if filter.OwnerID != nil {
        query = query.Where(sq.Eq{"owner_id": *filter.OwnerID})
    }
    if filter.OnlyUnassigned {
        // nil 的SQL语义是 IS NULL，不是忽略这个条件。
        query = query.Where(sq.Eq{"owner_id": nil})
    }

    sqlText, args, err := query.ToSql()
    if err != nil {
        return "", nil, fmt.Errorf("构造工单查询失败: %w", err)
    }
    return sqlText, args, nil
}

项目需在 go.mod 中声明并固定 github.com/Masterminds/squirrel 版本。调用方把接口参数解析成这个模型，再调用 BuildTicketQuery。指针只能保留本模型中的“提供或省略”；请求反序列化是否也保留显式 null，需要在传输模型中另外设计。

该函数允许所有可选字段都省略，结果是取前一百条工单。若产品不允许无筛选查询，应在入口额外拒绝，而不是期待 Eq 自动限制结果范围。Limit 也不替代租户权限条件。

让 Eq 处理 NULL 和列表语义

条件	SQL含义	应用注意点
不调用 Where	该条件省略	这才是不按该字段筛选
Eq{"owner_id": nil}	owner_id IS NULL	明确匹配无负责人
Eq{"owner_id": int64(0)}	等于占位参数0	0不是省略或NULL
Eq{"id": []int64{7, 11}}	id IN 两个占位参数	列表元素成为参数
Eq{"id": []int64{}}	恒假条件	不是取消id筛选