feat(auth): 添加JWT认证功能

- 引入github.com/golang-jwt/jwt/v5依赖包
- 创建utils/jwt.go文件实现JWT工具函数
- 定义JWTClaims结构体用于存储用户信息
- 实现GenerateToken函数生成JWT令牌
- 实现ParseToken函数解析JWT令牌
- 实现ValidateToken函数验证令牌有效性
- 添加令牌过期和无效的错误处理
This commit is contained in:
2026-02-03 11:57:30 +08:00
parent 14af10fdce
commit a4ca7a754f
3 changed files with 73 additions and 0 deletions
+70
View File
@@ -0,0 +1,70 @@
package utils
import (
"errors"
"time"
"github.com/golang-jwt/jwt/v5"
)
var (
ErrTokenInvalid = errors.New("token无效")
ErrTokenExpired = errors.New("token已过期")
)
// JWTClaims JWT声明
type JWTClaims struct {
UserID int `json:"user_id"`
Username string `json:"username"`
jwt.RegisteredClaims
}
// GenerateToken 生成JWT Token
func GenerateToken(userID int, username, secret string, expiresInHours int) (string, error) {
claims := JWTClaims{
UserID: userID,
Username: username,
RegisteredClaims: jwt.RegisteredClaims{
ExpiresAt: jwt.NewNumericDate(time.Now().Add(time.Duration(expiresInHours) * time.Hour)),
IssuedAt: jwt.NewNumericDate(time.Now()),
NotBefore: jwt.NewNumericDate(time.Now()),
},
}
token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
return token.SignedString([]byte(secret))
}
// ParseToken 解析JWT Token
func ParseToken(tokenString, secret string) (*JWTClaims, error) {
token, err := jwt.ParseWithClaims(tokenString, &JWTClaims{}, func(token *jwt.Token) (interface{}, error) {
if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok {
return nil, errors.New("签名方法无效")
}
return []byte(secret), nil
})
if err != nil {
return nil, err
}
if claims, ok := token.Claims.(*JWTClaims); ok && token.Valid {
return claims, nil
}
return nil, ErrTokenInvalid
}
// ValidateToken 验证Token是否有效
func ValidateToken(tokenString, secret string) error {
claims, err := ParseToken(tokenString, secret)
if err != nil {
return err
}
if claims.ExpiresAt != nil && claims.ExpiresAt.Time.Before(time.Now()) {
return ErrTokenExpired
}
return nil
}