在 goframe 框架中,联合查询的核心在于使用 dao 包提供的 fields() 方法指定多表字段,并通过 innerjoin() 或 leftjoin() 构建关联条件,最终利用 scan() 将结果映射到结构体。具体做法是定义包含所有目标字段的结构体,确保字段名与数据库列名一致或通过标签指定别名,然后在查询链式调用中拼接表连接逻辑并执行扫描。

如何编写带条件的多表内连接查询
针对需要严格匹配两表关系的场景,应使用 InnerJoin 并在 Where 中补充业务过滤条件。例如查询用户及其所属部门信息时,需明确连接键(如 user_id)和部门状态等额外限制。

package main
import (
"context"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
type UserDept struct {
Id int `json:"id"`
Name string `json:"name"`
DeptName string `json:"dept_name"`
}
func main() {
ctx := gctx.GetInitCtx()
var res []UserDept
// 假设已配置 db 实例
err := g.DB().Table("@user u")
.Fields("u.id", "u.name", "d.name as dept_name")
.InnerJoin("@department d", "u.dept_id = d.id")
.Where("u.status = ?", 1)
.Scan(&res)
if err != nil {
panic(err)
}
g.Dump(res)
}
上述代码执行后,res 切片中将填充满足 status=1 且存在对应部门记录的用户数据。若某用户无对应部门记录,则不会出现在结果集中,这符合内连接的定义。
如何处理左连接及空值映射
当需要保留主表所有记录,即使从表无匹配数据时,必须改用 LeftJoin。此时需注意,若关联字段为空,映射结构体中的对应字符串字段将保持零值(空字符串),而整型字段可能为 0,需在业务层进行判空处理。

package main
import (
"context"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
type UserDeptNullable struct {
Id int `json:"id"`
Name string `json:"name"`
DeptName *string `json:"dept_name,omitempty"` // 使用指针类型处理空值
}
func main() {
ctx := gctx.GetInitCtx()
var res []UserDeptNullable
err := g.DB().Table("@user u")
.Fields("u.id", "u.name", "d.name as dept_name")
.LeftJoin("@department d", "u.dept_id = d.id")
.Scan(&res)
if err != nil {
panic(err)
}
for _, item := range res {
if item.DeptName == nil {
item.DeptName = new(string)
*item.DeptName = "未分配部门"
}
}
g.Dump(res)
}
在此示例中,通过定义指针类型的 DeptName 字段,GoFrame 的 Scan 方法在数据库返回 NULL 时会自动将指针设为 nil。随后在代码中显式处理 nil 情况,将其替换为默认文本,从而保证前端展示的一致性。
基于部门ID为NULL时的结果映射行为
当输入数据中存在 dept_id 为 NULL 的记录时,左连接查询依然会返回该用户行,但关联的 d.name 字段值为 SQL 层面的 NULL。在 Go 语言结构体映射阶段,如果目标字段是普通 string 类型,它将映射为空字符串;如果是 *string 类型,则映射为 nil。这种差异直接决定了后续业务逻辑是否需要额外的空值检查。











