Golang Fiber框架JWT身份认证实现教程-Golang-PHP中文网

fiber.jwt中间件默认不校验token过期，因其底层jwt/v3仅用signingkey验证签名，不自动检查exp字段；需显式配置expirederror、timefunc及嵌入jwt.standardclaims才能启用时间校验。

golang fiber框架jwt身份认证实现教程

为什么 `fiber.JWT` 中间件默认不校验 token 过期？

因为 fiber.JWT（v2.40+）底层调用的是 github.com/gofiber/jwt/v3，而它的默认配置里 SigningKey 仅用于验证签名，不会自动检查 exp 字段。你拿到一个已过期的 token，中间件照样放行，直到你手动调用 c.Locals("user") 后解析才发现问题。

必须显式启用时间校验：

jwt.New(jwt.Config{
    SigningKey:   []byte("secret"),
    ContextKey:   "user",
    TokenLookup:  "header:Authorization",
    AuthScheme:   "Bearer",
    ExpiredError: func(c *fiber.Ctx) error {
        return c.Status(fiber.StatusUnauthorized).JSON(fiber.Map{"error": "token expired"})
    },
})

ExpiredError 是钩子函数，但只在 token 确实过期时触发——前提是 jwt 包能读到 exp 字段，所以签发时务必带上 exp
别漏掉 TimeFunc 配置：默认用 time.Now，若服务时钟不同步（比如容器没同步 NTP），会导致误判过期
如果你用的是自定义 claims 结构，要确保嵌入了 jwt.StandardClaims，否则 exp 不会被识别

如何安全地从 `c.Locals("user")` 提取用户 ID？

直接类型断言 c.Locals("user").(*jwt.Token) 是危险的——它可能为 nil（比如中间件没命中），也可能不是 *jwt.Token 类型（比如你改过配置的 ContextKey）。

正确做法是双重检查：

if user := c.Locals("user"); user != nil {
    if token, ok := user.(*jwt.Token); ok && token.Valid {
        if claims, ok := token.Claims.(jwt.MapClaims); ok {
            if id, ok := claims["id"].(float64); ok {
                userID := int64(id) // JSON number → float64 → int64
                // ✅ 安全使用 userID
            }
        }
    }
}

永远先判空再断言，c.Locals("user") 在未认证或解析失败时返回 nil
token.Valid 必须检查，它代表签名和时间都通过（前提是前面配了 ExpiredError 和标准 claims）
JWT payload 中的数字默认被解析为 float64，强转 int64 前确认无小数位，否则会丢精度

`fiber.JWT` 和自定义中间件混用时为啥总 401？

常见于你写了登录路由用 jwt.New() 生成 token，又在其他路由用另一个中间件做权限判断——但两个中间件的 SigningKey、TokenLookup 或 AuthScheme 不一致，导致解析失败。

典型错误组合：

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

登录接口返回的 token 用 Bearer xxx 格式，但保护路由中间件设了 AuthScheme: "Token"
前端把 token 放在 Cookie 里，但中间件只查 header:Authorization
开发环境用 "secret"，生产环境密钥从 env 读，但 env 没配，降级成空字符串 → 签名验证永远失败

调试技巧：在中间件里加一行日志，打印原始 token 字符串和解析错误：

jwt.New(jwt.Config{
    // ... 其他配置
    ErrorHandler: func(c *fiber.Ctx, err error) error {
        log.Printf("JWT error on %s: %v", c.Path(), err) // 查看具体哪步失败
        return c.Status(fiber.StatusUnauthorized).SendString("unauthorized")
    },
})