Go中类型一致但类型断言失败的问题排查

你遇到的问题本质是GORM会对底层的PostgreSQL错误进行包装，虽然打印错误类型显示为*pgconn.PgError，但实际返回的res.Error是被GORM封装后的错误对象，直接类型断言无法穿透包装层。

解决方案：使用errors.As穿透错误包装 #

Go标准库的errors.As函数可以遍历错误链，找到匹配目标类型的底层错误，不管中间有多少层包装。修改你的代码如下：

import "errors"
import "github.com/jackc/pgx/v5/pgconn"

res := tx.Take(&f, "id = ?", id)
if res.Error != nil {
    var pqErr *pgconn.PgError
    if errors.As(res.Error, &pqErr) {
        // 这里可以正常访问pqErr.Code等字段
        fmt.Printf("PostgreSQL错误码: %s\n", pqErr.Code)
    } else {
        fmt.Printf("非PostgreSQL原生错误: %T\n", res.Error)
    }
}

为什么直接断言无效？ #

GORM在处理数据库返回的错误时，会将原始错误包装到自己的错误结构中（比如*gorm.ErrRecordNotFound或通用的*gorm.Error）。虽然%T打印的是底层原始错误的类型，但实际的错误对象是GORM的包装类型，直接res.Error.(*pgconn.PgError)断言自然会失败。

验证错误链（可选） #

如果想确认错误的包装层级，可以用errors.Unwrap逐层拆解：

err := res.Error
for err != nil {
    fmt.Printf("当前错误类型: %T\n", err)
    err = errors.Unwrap(err)
}

这段代码会打印出错误链上的所有类型，你会看到GORM的包装类型和底层的*pgconn.PgError。

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