Golang 如何开发一个商品库存管理系统_Golang 后台 CRUD 项目实战

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

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

1. 项目结构设计

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

├── main.go
├── config/
│ └── db.go
├── models/
│ └── product.go
├── handlers/
│ └── product_handler.go
├── routes/
│ └── routes.go
└── utils/
└── response.go

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

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

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

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"`
}

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

3. 数据库连接配置

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

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")
    }
}

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

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

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

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"})
}

5. 路由注册

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

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
}

6. 主函数启动服务

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

package main

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

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

运行后访问 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 记录操作行为

基本上就这些。这个项目不复杂但容易忽略细节，比如参数校验、错误处理和数据库连接池配置。坚持写完，你会对 Go 的工程实践有更深理解。

# mysql # word # js # git # json # go # github # golang # 工具 # usb # 后端 # curl # ai # 路由 # restful # gin # postman

返回目录在线咨询

上一篇：Android实现RecyclerView添加分割线的简便方法
下一篇：建站之星管理中心：智能建站系统配置指南与技术论坛

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商