本文介绍在 Go 中将 SQL 查询结果映射到嵌套结构体时，如何确保空的子结构（如无关联 profile 的用户）不被输出到 JSON 响应中，核心方案是结合指针字段与 json:",omitempty" 标签，并在扫描数据库结果时按需初始化。
本文介绍在 go 中将 sql 查询结果映射到嵌套结构体时，如何确保空的子结构（如无关联 profile 的用户）不被输出到 json 响应中，核心方案是结合指针字段与 `json:",omitempty"` 标签，并在扫描数据库结果时按需初始化。
在使用 Go 处理关系型数据库（如 MySQL）并生成 JSON API 时，一个常见需求是：当主记录存在但关联的嵌套数据（如 Profile）为空时，完全省略该嵌套字段，而非输出一个空对象 {}。原代码中将 Profile 定义为值类型并使用 json:",omitempty" 是无效的——因为结构体的零值（如 Profile{}）不被视为“empty”，encoding/json 仅对 nil 指针、空切片/映射/字符串等才触发省略逻辑。
✅ 正确做法：使用指针 + 显式判空赋值
首先，修改 User 结构体，将 Profile 字段改为 *Profile 类型，并保留 omitempty：
type User struct {
Id int64 `json:"id"`
Username string `json:"username"`
Email string `json:"email"`
Profile *Profile `json:"profile,omitempty"` // ← 关键：指针类型 + omitempty
}
type Profile struct {
Id int64 `json:"id,omitempty"`
UserId int64 `json:"user_id,omitempty"`
Firstname *string `json:"firstname,omitempty"`
Lastname *string `json:"lastname,omitempty"`
}
接着，在 GetUsers 中，避免直接扫描到 &user.Profile.Firstname（因 user.Profile 初始为 nil，解引用 panic）。应先声明独立的 Profile 变量，扫描后判断是否非空，再动态分配指针：
func GetUsers(c *gin.Context) {
stmt, err := DB.Query(`
SELECT u.id, u.username, u.email, p.firstname, p.lastname
FROM users u
LEFT JOIN profiles p ON u.id = p.user_id
`)
if err != nil {
c.JSON(500, gin.H{"error": "query failed"})
return
}
defer stmt.Close()
var users []User
for stmt.Next() {
var user User
var profile Profile // 独立变量，用于接收扫描结果
// 注意：扫描时传入 profile 字段地址，而非 user.Profile 的嵌套地址
err := stmt.Scan(
&user.Id,
&user.Username,
&user.Email,
&profile.Firstname,
&profile.Lastname,
)
if err != nil {
log.Printf("scan error: %v", err)
continue // 跳过错误行，不 panic
}
// 判空逻辑：只要 Firstname 或 Lastname 非 nil，或需检查其他业务字段（如 Id > 0）
// 这里采用「非零值 profile」语义：若 firstname/lastname 至少一个有值，则视为有效 profile
if profile.Firstname != nil || profile.Lastname != nil {
// 可选：补全 UserId（来自 JOIN，但需从 user.Id 推导或额外 SELECT）
profile.UserId = user.Id
user.Profile = &profile
}
// 若 profile 全为空，则 user.Profile 保持 nil → JSON 序列化时被 omit
users = append(users, user)
}
c.JSON(200, users) // 无需 &users，gin.JSON 已处理
}
⚠️ 注意事项与最佳实践
- 不要扫描到 nil 指针字段：stmt.Scan(&user.Profile.Firstname) 会 panic，因 user.Profile == nil；必须先确保 user.Profile 已初始化（如 user.Profile = &Profile{}），或像上例一样用中间变量。
- 空值判断需贴合业务逻辑：Profile{} 的零值可能不足以代表“无数据”。例如，若 Id 或 UserId 为 0 才表示无效，应改为 if profile.UserId != 0 { ... }。
-
考虑使用 sql.NullString 提升健壮性：对于可能为 NULL 的字符串字段（如 firstname），推荐用 sql.NullString 替代 *string，避免手动处理 nil，且 NullString 的 Valid 字段天然支持判空：
type Profile struct { Firstname sql.NullString `json:"firstname,omitempty"` Lastname sql.NullString `json:"lastname,omitempty"` } // 扫描时：stmt.Scan(&profile.Firstname, &profile.Lastname) // 判空：if profile.Firstname.Valid || profile.Lastname.Valid { ... } - 性能提示：指针分配开销极小，且符合 Go JSON 序列化约定，无需过度优化。
✅ 最终 JSON 效果
- 有 profile 的用户：
{ "id": 1, "username": "test1", "email": "test1@example.com", "profile": { "firstname": "John", "lastname": "Doe" } } - 无 profile 的用户：
{ "id": 2, "username": "test2", "email": "test2@example.com" // ← "profile" 字段彻底消失 }
此方案简洁、安全、符合 Go 生态惯例，是处理可选关联数据的标准实践。
