使用sqlx映射PostgreSQL boolean[]到Golang []*bool字段时遇Scan错误

问题原因 #

PostgreSQL的boolean[]类型在数据库驱动中会以文本格式的[]uint8返回（例如"{true,false,null}"），而Go标准库和sqlx没有内置逻辑将这种格式直接映射到[]*bool类型——因为[]*bool需要用nil指针表示数组中的NULL值，普通布尔数组类型无法处理这种场景。

解决方案：自定义扫描类型 #

通过实现sql.Scanner接口（如果需要写入数据库还需实现driver.Valuer），手动解析PostgreSQL数组的文本格式，转换成[]*bool：

1. 定义自定义类型并实现扫描逻辑

import (
    "database/sql/driver"
    "fmt"
    "strings"
    "strconv"
)

// NullableBoolSlice 用于映射PostgreSQL的boolean[]到Go的[]*bool
type NullableBoolSlice []*bool

// Scan 实现sql.Scanner接口，解析PostgreSQL数组文本
func (n *NullableBoolSlice) Scan(value interface{}) error {
    if value == nil {
        *n = nil
        return nil
    }

    data, ok := value.([]byte)
    if !ok {
        return fmt.Errorf("expected []byte type for boolean[], got %T", value)
    }

    str := strings.Trim(string(data), "{}")
    // 处理空数组
    if str == "" {
        *n = nil
        return nil
    }

    elements := strings.Split(str, ",")
    result := make([]*bool, len(elements))

    for i, elem := range elements {
        elem = strings.TrimSpace(elem)
        if elem == "null" {
            result[i] = nil
            continue
        }

        b, err := strconv.ParseBool(elem)
        if err != nil {
            return fmt.Errorf("invalid boolean value %q at index %d: %w", elem, i, err)
        }
        result[i] = &b
    }

    *n = result
    return nil
}

// Value 实现driver.Valuer接口，将[]*bool转换为PostgreSQL数组文本（可选，若需写入数据库则实现）
func (n NullableBoolSlice) Value() (driver.Value, error) {
    if n == nil {
        return nil, nil
    }

    var elements []string
    for _, b := range n {
        if b == nil {
            elements = append(elements, "null")
        } else {
            elements = append(elements, strconv.FormatBool(*b))
        }
    }

    return "{" + strings.Join(elements, ",") + "}", nil
}

2. 修改结构体字段类型
   将原有的[]*bool替换为自定义的NullableBoolSlice：

type App struct {
    ApplicationID string            `db:"application_id"`
    Name          string            `db:"name"`
    Description   string            `db:"description"`
    Replicated    NullableBoolSlice `db:"replicated"`
}

3. 正常执行查询
   此时原有的查询代码即可正常工作：

var apps []App
err := trx.Select(&apps, "Select * From my_function()")

关键细节说明 #

• 处理了数组中的NULL元素：将文本中的"null"转换为nil指针
• 兼容空数组（{}）和字段本身为NULL的场景
• 自动去除元素前后的空格（PostgreSQL数组元素可能带空格）
• 可选实现Value方法，支持将NullableBoolSlice写回PostgreSQL的boolean[]字段

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