答案：本文介绍使用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 中定义商品结构体：
立即学习“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 记录操作行为
