当 JSON 数据中的时间字段为 Unix 秒级时间戳（如 1352289160）时，直接使用 time.Time 字段会导致反序列化失败；需通过 int64 中间类型转换，或实现自定义 UnmarshalJSON 方法完成安全解析。
当 json 数据中的时间字段为 unix 秒级时间戳（如 `1352289160`）时，直接使用 `time.time` 字段会导致反序列化失败；需通过 `int64` 中间类型转换，或实现自定义 `unmarshaljson` 方法完成安全解析。
在 Go 的 JSON 解析中，time.Time 默认期望符合 RFC 3339 格式的字符串（如 "2006-01-02T15:04:05Z"），而数据库或 API 返回的 Unix 时间戳（整数形式，单位：秒）无法被自动识别。若结构体字段声明为 time.Time 但实际输入是纯数字（如 "1352289160"），json.Unmarshal 将报错：
parsing time "1352289160" as "2006-01-02T15:04:05Z07:00": cannot parse "1352289160" as ""
✅ 推荐方案一：使用 int64 + 运行时转换（简洁安全）
将 Timestamp 字段改为 int64，避免 JSON 解析阶段出错，再按需转为 time.Time：
type Metrics struct {
Id int `orm:"column(id);auto"`
Name string `orm:"column(name);size(255);null" json:"metric_name"`
Timestamp int64 `orm:"column(timestamp);type(datetime)" json:"timestamp,omitempty"`
}
// 使用示例
func (m *Metrics) Time() time.Time {
return time.Unix(m.Timestamp, 0)
}
// 或在业务逻辑中直接调用
m := &Metrics{Timestamp: 1352289160}
t := time.Unix(m.Timestamp, 0) // → 2012-11-09 02:52:40 +0000 UTC✅ 优点：零依赖、无反射开销、类型安全、兼容 ORM（如 beego orm）和 JSON 双向序列化。
⚠️ 注意：确保源数据为秒级时间戳；若为毫秒级，需先除以 1000：time.Unix(m.Timestamp/1000, (m.Timestamp%1000)*1e6)。
✅ 推荐方案二：实现 UnmarshalJSON（语义更清晰）
若坚持结构体中保留 time.Time 字段以提升可读性与时间操作便利性，可为结构体实现自定义反序列化逻辑：
func (m *Metrics) UnmarshalJSON(data []byte) error {
// 定义临时 map 存储原始键值对
var raw map[string]interface{}
if err := json.Unmarshal(data, &raw); err != nil {
return err
}
// 手动映射字段（注意类型断言）
if name, ok := raw["metric_name"]; ok {
m.Name = name.(string)
}
if ts, ok := raw["timestamp"]; ok {
// JSON 数字默认解析为 float64
m.Timestamp = time.Unix(int64(ts.(float64)), 0)
}
// 其他字段依此类推...
return nil
}⚠️ 注意事项：
- 此方法需手动维护字段映射，易遗漏或出错；
- 若字段含嵌套结构或可选字段，建议结合
json.RawMessage延迟解析； -
UnmarshalJSON不影响json.Marshal行为——默认仍输出 RFC 3339 字符串（符合常规预期）。
? 总结
| 方案 | 适用场景 | 维护成本 | 时间操作便利性 |
|---|---|---|---|
int64 + time.Unix()
|
快速落地、ORM 集成强、时间格式简单 | 极低 | ⭐⭐（需显式转换） |
自定义 UnmarshalJSON
|
要求结构体字段原生为 time.Time，且项目已具备 JSON 处理规范 |
中高 | ⭐⭐⭐⭐⭐（直接使用 .Before(), .Add() 等） |
无论选择哪种方式，请始终校验时间戳范围（如 > 0 && ），避免因溢出或非法值导致 <code>time.Unix 返回零时间。
