首页 > Golang > Go教程

Golang用户认证系统实现教程

时间：2025-10-22 18:00:34 268浏览收藏

本教程将指导你使用 Golang 语言构建一个基础的用户认证系统，涵盖用户注册、登录、JWT（JSON Web Token）鉴权以及受保护路由的实现。该项目采用 Gin 框架处理 HTTP 请求，GORM 作为 ORM 操作 SQLite 数据库，并利用 bcrypt 算法对用户密码进行哈希加密，提升安全性。通过 JWT 中间件实现用户身份验证，确保只有授权用户才能访问特定路由。项目结构清晰，模块化设计，非常适合 Golang Web 开发初学者学习和实践，并在此基础上进行功能扩展，深入理解用户认证机制的实现原理。掌握本教程，你将能够构建一个安全可靠的用户认证系统，为你的 Golang Web 应用保驾护航。

实现用户认证系统，包含注册、登录、JWT鉴权及受保护路由。项目结构清晰，使用Gin框架与GORM操作SQLite数据库，通过bcrypt哈希密码，JWT实现中间件鉴权，适合学习扩展。

Golang实现基础用户认证系统项目

用Golang实现一个基础的用户认证系统，核心功能包括用户注册、登录、JWT鉴权和受保护的路由访问。整个项目结构清晰，适合学习和扩展。

项目结构设计

一个合理的项目结构有助于后期维护和扩展：

main.go：程序入口，路由配置
handlers/：处理HTTP请求逻辑
models/：定义用户结构体和数据库操作
middleware/：JWT鉴权中间件
utils/：工具函数，如密码哈希、生成JWT
database/：数据库连接初始化

用户模型与数据库连接

使用SQLite或PostgreSQL存储用户信息。这里以SQLite为例，使用gorm作为ORM。

定义用户模型：

package models
type User struct {
ID       uint   gorm:"primaryKey"
Username string gorm:"unique;not null"
Password string gorm:"not null"
}

初始化数据库连接：

package database
import (
"gorm.io/driver/sqlite"
"gorm.io/gorm"
)
var DB *gorm.DB
func Init() {
var err error
DB, err = gorm.Open(sqlite.Open("users.db"), &gorm.Config{})
if err != nil {
panic("failed to connect database")
}
DB.AutoMigrate(&User{})
}

注册与登录接口

在handlers/auth.go中实现注册和登录逻辑。

func Register(c *gin.Context) {
  var user models.User
  if err := c.ShouldBindJSON(&user); err != nil {
    c.JSON(400, gin.H{"error": "invalid input"})
    return
  }
hashedPassword, _ := utils.HashPassword(user.Password)
user.Password = hashedPassword
if err := database.DB.Create(&user).Error; err != nil {
c.JSON(400, gin.H{"error": "username already exists"})
return
}
c.JSON(201, gin.H{"message": "user created"})
}

func Login(c *gin.Context) {
  var input models.User
  if err := c.ShouldBindJSON(&input); err != nil {
    c.JSON(400, gin.H{"error": "invalid input"})
    return
  }
var user models.User
if err := database.DB.Where("username = ?", input.Username).First(&user).Error; err != nil {
c.JSON(401, gin.H{"error": "invalid credentials"})
return
}
if !utils.CheckPasswordHash(input.Password, user.Password) {
c.JSON(401, gin.H{"error": "invalid credentials"})
return
}
token, err := utils.GenerateJWT(user.Username)
if err != nil {
c.JSON(500, gin.H{"error": "could not generate token"})
return
}
c.JSON(200, gin.H{"token": token})
}

JWT中间件实现鉴权

在middleware/auth.go中实现JWT验证中间件。

package middleware
import (
"net/http"
"strings"
"github.com/dgrijalva/jwt-go"
"github.com/gin-gonic/gin"
)
var jwtKey = []byte("my_secret_key")
func AuthMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
authHeader := c.GetHeader("Authorization")
if authHeader == "" {
c.JSON(401, gin.H{"error": "missing authorization header"})
c.Abort()
return
}
tokenString := strings.TrimPrefix(authHeader, "Bearer ")
claims := &jwt.StandardClaims{}

token, err := jwt.ParseWithClaims(tokenString, claims, func(token *jwt.Token) (interface{}, error) {
  return jwtKey, nil
})

if err != nil || !token.Valid {
  c.JSON(401, gin.H{"error": "invalid or expired token"})
  c.Abort()
  return
}

c.Set("username", claims.Subject)
c.Next()
}
}

保护路由示例：

router.GET("/protected", middleware.AuthMiddleware(), func(c *gin.Context) {
  username := c.MustGet("username").(string)
  c.JSON(200, gin.H{"message": "hello " + username})
})

工具函数封装

在utils/jwt.go中生成JWT：

package utils
import (
"time"
"github.com/dgrijalva/jwt-go"
)
var jwtKey = []byte("my_secret_key")
func GenerateJWT(username string) (string, error) {
claims := &jwt.StandardClaims{
Subject:   username,
ExpiresAt: time.Now().Add(24 * time.Hour).Unix(),
}
token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
return token.SignedString(jwtKey)
}

密码哈希使用bcrypt：

package utils
import (
"golang.org/x/crypto/bcrypt"
)
func HashPassword(password string) (string, error) {
bytes, err := bcrypt.GenerateFromPassword([]byte(password), 12)
return string(bytes), err
}
func CheckPasswordHash(password, hash string) bool {
err := bcrypt.CompareHashAndPassword([]byte(hash), []byte(password))
return err == nil
}

基本上就这些。运行程序后，先注册用户，再用返回的token请求受保护接口。整个流程简单清晰，适合初学者理解Golang Web开发和认证机制。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang用户认证系统实现教程》文章吧，也可关注golang学习网公众号了解相关技术文章。