本文介绍如何在 Go 语言中正确解析 JWT 的 exp 声明并计算其剩余有效时间，重点解决因类型断言失败（int64 误判为 float64）导致的固定返回值问题，并提供健壮、可复用的实现方案。

本文介绍如何在 go 语言中正确解析 jwt 的 `exp` 声明并计算其剩余有效时间，重点解决因类型断言失败（`int64` 误判为 `float64`）导致的固定返回值问题，并提供健壮、可复用的实现方案。

JWT（JSON Web Token）的 exp（Expiration Time）字段是标准的 Unix 时间戳（单位：秒），由 jwt-go 等主流库解析后通常以 int64 类型存于 claims map 中（例如 map[string]interface{}），而非 float64。原代码中使用 timestamp.(float64) 进行类型断言，必然失败，导致逻辑始终跳转至默认返回值 expireOffset（如 3600），造成“永远返回 3600”的假象。

以下是修正后的健壮实现：

func getTokenRemainingValidity(timestamp interface{}) int {
    const expireOffset = 3600 // 示例偏移量（单位：秒），可根据业务需要调整或移除

    // 正确断言为 int64（JWT exp 标准类型）
    if exp, ok := timestamp.(int64); ok {
        expTime := time.Unix(exp, 0)
        remaining := expTime.Sub(time.Now())

        if remaining > 0 {
            // 注意：Seconds() 返回 float64，需显式转换；+ expireOffset 若非必需建议移除
            return int(remaining.Seconds()) + expireOffset
        }
    }
    return expireOffset
}

✅ 关键修正点说明：

• ✅ 类型匹配：exp 字段在 jwt-go v4+ 及多数兼容库中解析为 int64，必须使用 timestamp.(int64) 断言；
• ✅ 时间计算安全：time.Unix(exp, 0) 正确构造过期时间点，Sub() 返回 time.Duration，调用 Seconds() 获取秒级浮点值；
• ✅ 边界处理：显式检查 remaining > 0，避免负数时间返回无效正值；
• ⚠️ 关于 expireOffset：示例中保留该偏移量仅为兼容原有逻辑，实际生产中应谨慎评估其必要性——若用于补偿时钟偏差，建议改用 NTP 同步或服务端统一校准，而非硬编码补偿。

? 进阶建议（推荐）：
为提升可维护性与类型安全性，建议封装为结构体方法或使用强类型 claims：

type CustomClaims struct {
    Username string `json:"username"`
    Exp      int64  `json:"exp"`
}

func (c *CustomClaims) RemainingSeconds() int {
    if c.Exp <p>这样可彻底规避 interface{} 类型断言风险，同时增强代码可读性与测试性。</p><p>? <strong>总结</strong>：JWT exp 剩余时间计算的核心在于<strong>正确识别 exp 的实际 Go 类型（int64）</strong>，并结合 time.Now() 做安全的时间差运算。务必避免未经验证的类型断言，优先采用强类型 claims 结构或添加 default 分支处理未知类型，确保服务在 token 过期、解析异常等边界场景下行为可预期。</p>