Go中如何实现可复用泛型容器？分页场景类型不兼容报错解决

类型不兼容报错的核心原因 #

• 你定义的PagedStruct中elements字段类型为*[]interface{}，而传入的users是*[]User类型。
• Go是静态强类型语言，[]User和[]interface{}不存在任何隐式类型转换关系：[]interface{}本身是独立的切片类型，每个元素为固定结构的空接口值，和[]User的内存布局、类型标识完全不同。哪怕单个User值可以被赋值给空接口变量，切片层面的类型不兼容规则依然生效，因此直接赋值会触发编译期报错。
• 额外的常见坑：你定义的结构体字段都是小写开头的未导出属性，跨包使用时无法被外部代码访问和初始化，需要调整为大写开头才能跨包复用。

Go 1.18+ 标准泛型实现（推荐） #

直接使用Go原生支持的类型参数机制定义泛型分页容器，完全规避空接口带来的类型兼容问题，是目前的最优解：

// 泛型分页结构体，类型参数T支持任意类型
type PagedResult[T any] struct {
    Elements []T    // 直接存储对应类型的切片，无额外转换
    Page     int16
    Total    int16
}

使用示例：

// 业务结构体定义
type User struct {
    ID    int64
    Name  string
    Email string
    Phone string
    Dept  string
}

// 构造User类型的分页结果
func GetUserListPage() *PagedResult[User] {
    userList := []User{
        {1, "测试用户", "test@example.com", "13800138000", "技术部"},
    }
    return &PagedResult[User]{
        Elements: userList,
        Page:     1,
        Total:    1,
    }
}

方案优势：

• 全链路编译期类型检查，无运行时类型断言的性能损耗
• 无额外的切片元素拷贝开销
• 新增其他类型的分页逻辑时，只需要替换泛型参数即可复用结构体定义，不需要重复编写重复的分页结构体代码

低版本Go（1.17及更早）兼容方案 #

如果项目暂时无法升级到支持泛型的Go版本，不能直接传递具体类型切片给[]interface{}字段，需要手动完成逐元素的类型转换：

// 旧版本兼容的分页结构体
type PagedStruct struct {
    Elements *[]interface{}
    Page     int16
    Total    int16
}

func GetUserListPageLegacy() *PagedStruct {
    userList := []User{
        {1, "测试用户", "test@example.com", "13800138000", "技术部"},
    }
    // 逐元素将具体类型值转换为空接口，构造合法的[]interface{}实例
    elementHolder := make([]interface{}, len(userList))
    for idx, item := range userList {
        elementHolder[idx] = item
    }
    return &PagedStruct{
        Elements: &elementHolder,
        Page:     1,
        Total:    1,
    }
}

方案注意事项：

• 从Elements字段读取数据时，必须执行强制类型断言，例如user, ok := pagedRes.Elements[0].(User)，断言失败时会直接触发运行时panic
• 逐元素拷贝会带来一定的内存和性能开销
• 所有类型校验都在运行时完成，编译期无法提前发现类型不匹配的问题，线上稳定性较差

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