Golang库存系统开发实战教程

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Golang 商品库存系统开发实战》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

答案：本文介绍使用Gin+GORM+MySQL开发商品库存管理系统，涵盖项目结构、数据库模型定义、连接配置、CRUD接口实现、路由注册及主服务启动，帮助Go初学者掌握Web后端核心技能。

开发一个商品库存管理系统是 Golang 初学者掌握 Web 后端开发的典型实战项目。通过这个项目，你可以熟悉路由控制、数据库操作、请求处理和 RESTful API 设计等核心技能。下面以 Gin 框架 + GORM + MySQL 为例，带你一步步实现一个基础但完整的库存管理系统。

1. 项目结构设计

合理的目录结构有助于后期维护和扩展。建议采用如下结构：

这种分层方式将数据库模型、业务逻辑、路由和工具函数分离，便于管理。

2. 数据库模型定义（GORM）

在 models/product.go 中定义商品结构体：

<font face="monospace">package models

type Product struct {
    ID          uint   `gorm:"primaryKey" json:"id"`
    Name        string `json:"name" binding:"required"`
    Description string `json:"description"`
    Price       float64 `json:"price" binding:"required"`
    Stock       int    `json:"stock" binding:"required"`
}
</font>

使用 GORM 标签映射数据库字段，JSON 标签用于接口数据交互，binding 用于参数校验。

3. 数据库连接配置

在 config/db.go 中初始化 MySQL 连接：

<font face="monospace">package config

import (
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
)

var DB *gorm.DB

func InitDB() {
    dsn := "user:password@tcp(127.0.0.1:3306)/inventory?charset=utf8mb4&parseTime=True&loc=Local"
    var err error
    DB, err = gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
}
</font>

确保提前创建 inventory 数据库，并允许程序自动建表。

4. CRUD 接口实现（Gin + GORM）

在 handlers/product_handler.go 中编写增删改查逻辑：

<font face="monospace">package handlers

import (
    "net/http"
    "github.com/gin-gonic/gin"
    "your_project/models"
    "your_project/config"
)

// 获取所有商品
func GetProducts(c *gin.Context) {
    var products []models.Product
    config.DB.Find(&products)
    c.JSON(http.StatusOK, products)
}

// 创建商品
func CreateProduct(c *gin.Context) {
    var product models.Product
    if err := c.ShouldBindJSON(&product); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    config.DB.Create(&product)
    c.JSON(http.StatusCreated, product)
}

// 根据 ID 查询商品
func GetProductByID(c *gin.Context) {
    id := c.Param("id")
    var product models.Product
    if err := config.DB.First(&product, id).Error; err != nil {
        c.JSON(http.StatusNotFound, gin.H{"error": "Product not found"})
        return
    }
    c.JSON(http.StatusOK, product)
}

// 更新商品
func UpdateProduct(c *gin.Context) {
    id := c.Param("id")
    var product models.Product
    if err := config.DB.First(&product, id).Error; err != nil {
        c.JSON(http.StatusNotFound, gin.H{"error": "Product not found"})
        return
    }

    if err := c.ShouldBindJSON(&product); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }

    config.DB.Save(&product)
    c.JSON(http.StatusOK, product)
}

// 删除商品
func DeleteProduct(c *gin.Context) {
    id := c.Param("id")
    result := config.DB.Delete(&models.Product{}, id)
    if result.RowsAffected == 0 {
        c.JSON(http.StatusNotFound, gin.H{"error": "Product not found"})
        return
    }
    c.JSON(http.StatusOK, gin.H{"message": "Product deleted"})
}
</font>

5. 路由注册

在 routes/routes.go 中统一管理路由：

<font face="monospace">package routes

import (
    "your_project/handlers"
    "github.com/gin-gonic/gin"
)

func SetupRouter() *gin.Engine {
    r := gin.Default()
    r.GET("/products", handlers.GetProducts)
    r.POST("/products", handlers.CreateProduct)
    r.GET("/products/:id", handlers.GetProductByID)
    r.PUT("/products/:id", handlers.UpdateProduct)
    r.DELETE("/products/:id", handlers.DeleteProduct)
    return r
}
</font>

6. 主函数启动服务

在 main.go 中集成所有组件：

<font face="monospace">package main

import (
    "your_project/config"
    "your_project/routes"
)

func main() {
    config.InitDB()
    r := routes.SetupRouter()
    r.Run(":8080")
}
</font>

运行后访问 http://localhost:8080/products 即可测试接口。

7. 测试与调试建议

使用 curl 或 Postman 测试各接口：

• 创建商品：POST /products，Body 传 JSON 数据
• 查询列表：GET /products
• 更新库存：PUT /products/1，修改 stock 字段
• 删除商品：DELETE /products/1

可在数据库中查看数据变化，确认操作生效。

8. 可扩展功能

基础 CRUD 完成后，可逐步添加：

• 分页查询：加入 limit 和 offset 参数
• 模糊搜索：按商品名查询 Like 条件
• 库存预警：当 stock ≤ 5 时标记提醒
• JWT 认证：保护接口安全
• 日志记录：用 Zap 记录操作行为

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