本文详解如何通过实现 driver.Valuer 和 sql.Scanner 接口，使 Gorp 能正确读写 Go 自定义类型（如 type Role string），解决“unsupported type”错误，无需手动注册 TypeConverter。
本文详解如何通过实现 `driver.valuer` 和 `sql.scanner` 接口，使 gorp 能正确读写 go 自定义类型（如 `type role string`），解决“unsupported type”错误，无需手动注册 `typeconverter`。
Gorp 本身不强制要求使用 gorp.TypeConverter 来处理自定义类型——它底层完全依赖 Go 标准库的 database/sql 驱动机制。只要你的自定义类型实现了 driver.Valuer（用于写入数据库）和 sql.Scanner（用于从数据库读取），Gorp 就能自动识别并无缝集成，无需额外配置或显式注册转换器。
这是最符合 Go 生态惯用法、也最轻量可靠的方案。以角色枚举 Role 为例：
type Role string
const (
RoleAdmin Role = "admin"
RoleModerator Role = "moderator"
RoleUser Role = "user"
)
// 实现 sql.Scanner：从数据库值（如 string）反序列化为 Role
func (r *Role) Scan(value interface{}) error {
if value == nil {
*r = ""
return nil
}
s, ok := value.(string)
if !ok {
return fmt.Errorf("cannot scan %T into Role", value)
}
*r = Role(s)
return nil
}
// 实现 driver.Valuer：将 Role 序列化为数据库可接受的值（string）
func (r Role) Value() (driver.Value, error) {
return string(r), nil
}注意：
- Scan 方法必须是指针接收者（*Role），因为需要修改原值；
- Value 方法是值接收者（Role），符合不可变语义；
- 两者都应妥善处理 nil 值（如数据库字段允许 NULL）；
- 类型断言需加错误检查，避免 panic（生产环境务必校验）。
配合结构体使用时，确保字段标签正确声明：
type Account struct {
User string `db:"user"`
Role Role `db:"role"` // Gorp 会自动调用 Role.Value() 和 Role.Scan()
}完整工作示例（含测试验证）：
func TestAccountWithRole(t *testing.T) {
db, mock, _ := sqlmock.New()
defer db.Close()
dbMap := &gorp.DbMap{
Db: db,
Dialect: gorp.MySQLDialect{Engine: "InnoDB"},
}
dbMap.AddTableWithName(Account{}, "account").SetKeys(false, "User")
// 模拟 SELECT 查询返回 role="admin"
mock.ExpectQuery(`SELECT \* FROM account`).WillReturnRows(
sqlmock.NewRows([]string{"user", "role"}).AddRow("alice", "admin"),
)
var acc Account
err := dbMap.SelectOne(&acc, "SELECT * FROM account")
require.NoError(t, err)
assert.Equal(t, RoleAdmin, acc.Role) // ✅ 正确解析
// 模拟 INSERT：Role("moderator") 自动转为 "moderator" 字符串
mock.ExpectExec(`INSERT INTO account`).WithArgs("bob", "moderator").WillReturnResult(
sqlmock.NewResult(1, 1),
)
acc2 := Account{User: "bob", Role: RoleModerator}
_, err = dbMap.Insert(&acc2)
require.NoError(t, err)
}✅ 关键总结：
- ✅ 优先实现 Valuer + Scanner，而非依赖 TypeConverter（Gorp 的 TypeConverter 主要用于无法修改类型的第三方类型，且已逐渐被标准接口取代）；
- ✅ 所有基于 database/sql 的 ORM（包括 Gorp、sqlx、ent 等）均统一支持该机制，代码具备强可移植性；
- ✅ 若类型含复杂逻辑（如 JSON 编码、加密等），可在 Value()/Scan() 中封装，保持业务层干净；
- ⚠️ 切勿忽略 nil 处理与类型校验，否则易在运行时 panic。
遵循此模式，你可轻松扩展任意自定义类型（时间别名、货币、IP 地址、加密 ID 等）与数据库的双向映射。
