需依赖github.com/golang-jwt/jwt/v5，密钥须为≥32字节的[]byte类型，禁止硬编码，应从环境变量（如JWT_SECRET）加载并显式转换；Claims推荐用嵌入jwt.RegisteredClaims的结构体实现，确保ExpiresAt等标准字段正确设置。
JWT生成需要哪些依赖和密钥配置
Echo本身不内置JWT功能，得靠github.com/golang-jwt/jwt/v5（v5是当前主流）配合手动签发。密钥必须是[]byte类型，不能直接用字符串字面量硬编码——容易被反编译提取；推荐从环境变量读取后用os.Getenv("JWT_SECRET")加载，并确保长度≥32字节（HS256要求）。如果密钥太短，jwt.NewWithClaims不会报错，但token.SignedString()会panic：「key is of invalid size」。
如何用Echo上下文构造标准JWT Claims
别直接用jwt.MapClaims写字段，它缺乏类型安全且易拼错键名。应该定义结构体实现jwt.Claims接口，嵌入jwt.RegisteredClaims以支持ExpiresAt、IssuedAt等标准字段：
type JWTClaims struct {
UserID uint `json:"user_id"`
jwt.RegisteredClaims
}生成时传入该结构体实例，例如：
claims := JWTClaims{
UserID: 123,
RegisteredClaims: jwt.RegisteredClaims{
ExpiresAt: jwt.NewNumericDate(time.Now().Add(24 * time.Hour)),
IssuedAt: jwt.NewNumericDate(time.Now()),
},
}
token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)签名失败的三个常见原因
token.SignedString()返回空字符串或panic，通常因为：
- 密钥类型错误：传了
string而非[]byte，需显式转换[]byte(secret) - SigningMethod不匹配：前端期望HS256但代码用了ES256，或反之；Echo路由中解析时也必须用同一算法
- Claims结构体字段未导出：JSON序列化失败导致payload为空，检查字段是否首字母大写、有
json:标签
在Echo Handler里返回Token的最小可行写法
不要在中间件里自动生成Token，应只在登录成功后的Handler中生成并返回。典型流程是校验账号密码后调用签发逻辑，再用c.JSON返回：
func loginHandler(c echo.Context) error {
// ... 验证用户名密码
tokenStr, err := token.SignedString([]byte(os.Getenv("JWT_SECRET")))
if err != nil {
return echo.NewHTTPError(http.StatusInternalServerError, "token gen failed")
}
return c.JSON(http.StatusOK, map[string]string{
"token": tokenStr,
})
}注意：SignedString内部会做base64编码和签名，结果是标准JWT格式（header.payload.signature），可直接给前端存localStorage。
真正麻烦的是后续的Token校验和刷新逻辑，那部分没标准解法，得自己处理过期时间、黑名单、refresh token存储这些事。
