需先从c.Get("user")获取*jwt.Token，再通过token.Claims.(jwt.MapClaims)["role"]提取；若为数组则需类型断言为[]interface{}并逐个转string，或使用自定义Claims结构体声明Role字段并匹配JSON tag。
JWT解析后怎么从Claims里取role字段
Echo框架本身不负责解析JWT，得靠第三方库（比如github.com/golang-jwt/jwt/v5）解签后手动提取。关键不是Echo怎么拿，而是你解析出的jwt.MapClaims或自定义Claims结构体里有没有role这个键。
常见错误是直接用token.Claims["role"]却忽略类型断言——因为MapClaims里所有值都是interface{}，必须显式转成string或[]interface{}（如果是角色数组）：
if claims, ok := token.Claims.(jwt.MapClaims); ok && token.Valid {
if role, ok := claims["role"].(string); ok {
// ✅ 成功拿到单角色字符串
}
if roles, ok := claims["role"].([]interface{}); ok {
// ✅ 处理角色列表，需逐个转string
for _, r := range roles {
if s, ok := r.(string); ok {
// ...
}
}
}
}
为什么c.Get("user")取不到role？
Echo中间件（如middleware.JWT）默认只把解析后的*jwt.Token存进上下文"user"键，不会自动展开Claims。你不能直接c.Get("user").(map[string]interface{})["role"]，因为c.Get("user")返回的是*jwt.Token指针，不是Claims本身。
正确做法是先取*jwt.Token，再访问其Claims字段：
token := c.Get("user").(*jwt.Token)
claims := token.Claims.(jwt.MapClaims)
role := claims["role"]
注意：必须确保中间件已成功验证并注入"user"，否则c.Get("user")是nil，强制类型断言会panic。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
自定义Claims结构体时role字段怎么声明
如果用自定义Claims（实现jwt.Claims接口），role字段类型要匹配实际JWT载荷格式：
- 单角色字符串：
Role string `json:"role"` - 多角色数组：
Role []string `json:"role"`或Roles []string `json:"roles"`（注意JWT里实际key名）
解析时要用ParseWithClaims传入该结构体指针，否则仍走MapClaims。字段名和JSON tag必须与签发时一致，大小写敏感。
中间件里提前提取role并存入上下文更省事
与其每次手动解析，不如在JWT中间件之后加一层预处理：
func RoleMiddleware() echo.MiddlewareFunc {
return func(next echo.Handler) echo.Handler {
return echo.HandlerFunc(func(c echo.Context) error {
user := c.Get("user")
if user == nil {
return echo.ErrUnauthorized
}
token := user.(*jwt.Token)
claims := token.Claims.(jwt.MapClaims)
// 提前提取role，统一存到context
if role, ok := claims["role"].(string); ok {
c.Set("role", role)
} else if roles, ok := claims["role"].([]interface{}); ok {
var roleList []string
for _, r := range roles {
if s, ok := r.(string); ok {
roleList = append(roleList, s)
}
}
c.Set("roles", roleList)
}
return next.ServeHTTP(c.Response(), c.Request())
})
}
}
后续handler里直接c.Get("role")或c.Get("roles")就行。注意别覆盖Echo原生"user"，避免干扰其他逻辑。
JWT载荷结构不统一时，role字段名、类型、嵌套层级都可能不同，硬编码取值容易崩——最稳妥的方式是签发方约定规范，消费方按约定解析，而不是依赖通用中间件自动映射。
