本文详细讲解如何通过实现 Valuer 和 Scanner 接口，使自定义 Go 结构体 Point 兼容 GORM 与 PostgreSQL 的原生 POINT 类型，实现高效、类型安全的地理坐标存储与读取。
本文详细讲解如何通过实现 `valuer` 和 `scanner` 接口，使自定义 go 结构体 `point` 兼容 gorm 与 postgresql 的原生 `point` 类型，实现高效、类型安全的地理坐标存储与读取。
在 Go 生态中，GORM 本身不直接支持 PostgreSQL 的几何类型（如 POINT），也无法自动序列化/反序列化自定义结构体。要将 Point 类型持久化到 PostgreSQL 并正确读回，关键在于让 Go 类型满足数据库驱动所需的接口契约：driver.Valuer（用于写入）和 sql.Scanner（用于读取）。
✅ 正确实现 Point 类型
首先定义结构体：
type Point struct {
X, Y float64
}
接着实现 driver.Valuer 接口，将 Point 转为 PostgreSQL 所需的 (x,y) 字符串格式（注意：PostgreSQL 几何类型 POINT 的文本表示必须带括号且无空格）：
import (
"database/sql/driver"
"strconv"
)
func (p Point) Value() (driver.Value, error) {
out := []byte{'('}
out = strconv.AppendFloat(out, p.X, 'f', -1, 64)
out = append(out, ',')
out = strconv.AppendFloat(out, p.Y, 'f', -1, 64)
out = append(out, ')')
return string(out), nil // 返回 string 更安全（避免 []byte 误判为 binary）
}
再实现 sql.Scanner 接口，从数据库返回的 []byte 或 string 中解析出坐标：
import (
"database/sql"
"errors"
"strconv"
"strings"
)
func (p *Point) Scan(src interface{}) error {
if src == nil {
*p = Point{} // 或设为零值，按业务需求决定
return nil
}
var data string
switch v := src.(type) {
case []byte:
data = string(v)
case string:
data = v
default:
return errors.New("(*Point).Scan: unsupported type, expected string or []byte")
}
// 去除首尾括号："(1.5,2.7)" → "1.5,2.7"
data = strings.TrimSpace(data)
if len(data) <h3>? 在 GORM 模型中使用</h3><p>定义模型时直接嵌入 Point 字段，并确保数据库列类型为 POINT（GORM 不会自动创建该类型，需手动建表或迁移）：</p><pre class="brush:php;toolbar:false;">type Location struct {
ID uint `gorm:"primaryKey"`
Name string `gorm:"not null"`
Coords Point `gorm:"type:point;not null"` // 显式声明 PostgreSQL 类型
}建表 SQL 示例（推荐在迁移中执行）：
CREATE TABLE locations (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL,
coords POINT NOT NULL
);⚠️ 注意事项与最佳实践
- 类型安全：务必检查 Scan 中 src 的类型，避免 panic；对空值（nil）应明确处理。
- 格式校验：PostgreSQL 对 POINT 文本格式敏感（如 (1,2) 合法，1,2 或 (1, 2) 可能失败），解析时建议严格校验括号与逗号结构。
- 性能考虑：strconv.AppendFloat 比 fmt.Sprintf 更高效，适用于高频写入场景。
- 扩展性：如需支持 LINESTRING、POLYGON 等更复杂几何类型，可沿用相同模式，但需适配对应 PostgreSQL 文本语法。
- 替代方案：若项目允许，也可考虑使用 pgtype + pgx 配合 GORM 的 DriverName("pgx")，获得更完整的 PostGIS 支持（需额外引入 github.com/jackc/pgtype）。
通过以上实现，Point 即可作为一等公民参与 GORM 的 CRUD 流程，兼顾简洁性、可维护性与数据库原生能力。
