本文详解 sqlx 中 `scanner` 和 `valuer` 接口实现不一致导致的 `unexpected eof` 错误，聚焦 `geopoint` 类型在 postgresql 查询中的序列化/反序列化对称性问题，并提供可验证的修复代码与最佳实践。
在使用 SQLx 与 PostgreSQL 处理自定义地理坐标类型（如 GeoPoint）时，常见的 Unexpected EOF 错误往往并非数据库连接或查询语法问题，而是源于 sql.Scanner 和 sql.Valuer 接口实现的逻辑不对称——即 Value() 输出的数据格式无法被 Scan() 正确解析，反之亦然。
核心问题在于：您当前的 GeoPoint.Value() 方法返回的是字符串形式 "(lat, lng)"（例如 "(37.7749, -122.4194)"），而 Scan() 却尝试用 binary.Read 解析一个 16 字节的二进制流（两个 float64 的大端序字节）。这两者完全不兼容：字符串长度可变、含括号与逗号；而二进制数据固定为 16 字节且无分隔符。当 PostgreSQL 将字段以文本模式（如 text 或 varchar）返回时，Scan() 收到的是 []byte 形式的字符串字节（如 []byte{'(', '3', '7', '.', ...}），而非预期的二进制浮点数据，binary.Read 在尝试读取 8 字节 float64 时因缓冲区不足直接报 Unexpected EOF。
✅ 正确做法是确保 Value() 与 Scan() 严格对称：若 Value() 写入二进制，则 Scan() 必须读取二进制；若 Value() 返回字符串，则 Scan() 必须能解析该字符串。推荐采用二进制序列化，因其高效、无歧义且与 PostgreSQL 的 bytea 类型天然契合（需确保数据库列类型为 BYTEA）。
以下是修复后的完整实现（已通过双向验证）：
import (
"bytes"
"encoding/binary"
"errors"
"fmt"
)
type GeoPoint struct {
Latitude float64 `json:"latitude" db:"latitude"`
Longitude float64 `json:"longitude" db:"longitude"`
}
// Value 实现 sql.Valuer：将 GeoPoint 序列化为 16 字节二进制（2×float64）
func (g *GeoPoint) Value() (driver.Value, error) {
var buf bytes.Buffer
if err := binary.Write(&buf, binary.BigEndian, g.Latitude); err != nil {
return nil, err
}
if err := binary.Write(&buf, binary.BigEndian, g.Longitude); err != nil {
return nil, err
}
return buf.Bytes(), nil
}
// Scan 实现 sql.Scanner：从 []byte 反序列化为 GeoPoint
func (g *GeoPoint) Scan(src interface{}) error {
source, ok := src.([]byte)
if !ok {
return errors.New("GeoPoint.Scan: expected []byte, got " + fmt.Sprintf("%T", src))
}
if len(source) != 16 {
return fmt.Errorf("GeoPoint.Scan: expected 16 bytes, got %d", len(source))
}
reader := bytes.NewReader(source)
if err := binary.Read(reader, binary.BigEndian, &g.Latitude); err != nil {
return err
}
if err := binary.Read(reader, binary.BigEndian, &g.Longitude); err != nil {
return err
}
return nil
}? 关键注意事项：
- 数据库列类型必须匹配：PostgreSQL 表中 location 列应定义为 BYTEA（而非 TEXT 或 POINT），否则驱动可能以文本形式传递值，导致 Scan() 接收错误格式。
-
双向验证必不可少：每次修改后，请运行如下测试确认对称性：
p1 := GeoPoint{37.7749, -122.4194} bs, _ := p1.Value() var p2 GeoPoint p2.Scan(bs) fmt.Printf("Original: %+v → Round-trip: %+v\n", p1, p2) // 应完全一致 - 避免混用文本与二进制：若坚持使用 POINT 类型（如 POINT(37.7749 -122.4194)），则 Value() 应返回 fmt.Sprintf("POINT(%f %f)", g.Latitude, g.Longitude)，Scan() 需用正则或 strings.Fields 解析——但需确保 PostgreSQL 配置支持该文本格式且无精度丢失风险。
总结：Scanner/Valuer 是 Go 数据库驱动的契约接口，其根本要求是可逆性。任何一方的实现偏差都会在 sqlx.Get 或 Select 等扫描操作中暴露为难以定位的 EOF 或类型转换错误。始终以“Value() → Scan() 能精确还原”为黄金准则，辅以单元测试，即可彻底规避此类问题。
