Go与sqlx嵌入结构体处理JOIN查询：LEFT JOIN NULL值求解

问题背景 #

使用Go操作PostgreSQL数据库，数据库Schema如下：

CREATE TABLE product (
  id INT not null,
  name text not null,
  price int not null
);
INSERT INTO product (id, name, price) VALUES (1, 'PR1', 100);
INSERT INTO product (id, name, price) VALUES (2, 'PR2', 200);

CREATE TABLE discount (
  id INT not null,
  percentage int not null,
  product_id int not null
);
INSERT INTO discount (id, percentage, product_id) VALUES (1, 10, 1);

对应的Go结构体定义：

type Product struct{
 Id int `db:"id"`
 Name string `db:"name"`
 Price int `db:"price"`
}

type Discount struct {
 Id int `db:"id"`
 Percentage int `db:"percentage"`
 Product_id int `db:"product_id"`
}

遇到的问题：

• INNER JOIN查询时数据映射正常；
• 使用LEFT JOIN关联两张表时，无对应折扣的商品会返回NULL值，直接映射到非指针类型的结构体字段会触发错误；
• 不想通过到处加指针或PostgreSQL的COALESCE函数解决，寻求优雅的结构体嵌入处理方式。

解决方案 #

1. 自定义NULL兼容类型 #

为可能出现NULL的字段定义自定义类型，实现sql.Scanner接口处理NULL映射，无需修改原有结构体结构，也不用指针：

import "fmt"
import "database/sql"

// 自定义兼容NULL的int类型
type NullInt int

func (n *NullInt) Scan(value interface{}) error {
    if value == nil {
        *n = 0 // 可根据业务需求设置默认值，比如-1表示无数据
        return nil
    }
    val, ok := value.(int64)
    if !ok {
        return fmt.Errorf("invalid type for NullInt: %T", value)
    }
    *n = NullInt(val)
    return nil
}

// 定义用于JOIN查询的组合结构体
type ProductWithDiscount struct {
    Product
    DiscountId       NullInt `db:"discount_id"`
    DiscountPercentage NullInt `db:"discount_percentage"`
}

查询时直接映射到ProductWithDiscount，NULL值会被自动转为预设的默认值，避免报错。

2. 拆分查询，代码层关联数据 #

完全避免JOIN带来的NULL问题，分两步查询后在Go代码中关联：

1. 查询所有商品：

SELECT id, name, price FROM product;

2. 批量查询所有关联的折扣：

SELECT id, percentage, product_id FROM discount WHERE product_id IN ($1, $2, ...);

3. 用map[int]Discount将折扣按product_id分组，遍历商品列表匹配对应的折扣数据。

这种方式逻辑清晰，无需修改结构体类型，也不会涉及NULL值映射问题。

3. 结构体嵌套+存在标识字段 #

定义包含商品和折扣的组合结构体，新增标识字段判断折扣是否存在：

type ProductWithDiscount struct {
    Product
    Discount
    HasDiscount bool `db:"has_discount"`
}

查询时通过CASE语句生成标识字段：

SELECT 
    p.*, 
    d.id, d.percentage, d.product_id, 
    CASE WHEN d.id IS NOT NULL THEN true ELSE false END AS has_discount
FROM product p
LEFT JOIN discount d ON p.id = d.product_id;

映射后可通过HasDiscount字段判断折扣是否有效，即使折扣字段因NULL映射为默认值（int默认0），也能通过标识区分真实数据与空值。

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