基于go语言编辑使用的mysql数据库：从环境配置到CRUD实战

原创于 2026-04-23 13:25:57 发布 · 379 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

为了使我的学习更有效率，我决定把 Go 语言操作 MySQL 数据库的完整流程记录下来，包括环境配置、依赖管理、连接池使用和基础 CRUD 操作，帮你避开常见的坑，快速上手开发。

一、环境的准备与路径依赖的配置

1：安装go环境与验证

首先确保你的 Go 环境正常（Go 1.16+ 推荐），在终端执行：

go version
# 输出类似：go version go1.26.1 windows/amd64

2：初始化go模块

在项目根目录执行，创建go.mod文件：

go mod init backend_project

3：安装grom与mysql驱动

GORM 是 Go 语言最流行的 ORM 库，我们用它来简化数据库操作

# 安装GORM核心库
go get gorm.io/gorm
# 安装MySQL驱动
go get gorm.io/driver/mysql

执行完后，用go mod tidy自动补全依赖并生成go.sum文件，解决你之前遇到的依赖缺失问题。

二、数据库连接配置

1：基础连接示例

package main

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

func main() {
  // 1. 拼接DSN（数据源名称）
  dsn := "root:你的密码@tcp(127.0.0.1:3306)/test_db?charset=utf8mb4&parseTime=True&loc=Local"
  
  // 2. 连接数据库
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
  if err != nil {
    log.Fatalf("数据库连接失败: %v", err)
  }
  log.Println("数据库连接成功！")
}

2：连接池配置（生产环境必看）

为了避免连接泄漏，建议配置连接池参数：

sqlDB, err := db.DB()
if err != nil {
  log.Fatal(err)
}
// 设置最大打开连接数
sqlDB.SetMaxOpenConns(100)
// 设置最大空闲连接数
sqlDB.SetMaxIdleConns(10)
// 设置连接最大存活时间
sqlDB.SetConnMaxLifetime(300)

三、模型定义与表创建

定义一个用户表模型，GORM 会自动帮你创建表：

type User struct {
  gorm.Model        // 自带ID、CreatedAt、UpdatedAt、DeletedAt字段
  Name    string    `gorm:"size:20;not null;comment:用户名"`
  Age     int       `gorm:"comment:年龄"`
  Email   string    `gorm:"size:50;unique;comment:邮箱"`
}

func initTable(db *gorm.DB) {
  // 自动迁移表结构（不存在则创建，存在则更新字段）
  err := db.AutoMigrate(&User{})
  if err != nil {
    log.Fatalf("表创建失败: %v", err)
  }
  log.Println("用户表创建/迁移成功！")
}

四、基础 CRUD 操作实战

1：新增数据

func createUser(db *gorm.DB) {
  user := User{
    Name:  "张三",
    Age:   20,
    Email: "zhangsan@example.com",
  }
  result := db.Create(&user)
  if result.Error != nil {
    log.Printf("新增用户失败: %v", result.Error)
    return
  }
  log.Printf("新增用户成功，ID: %d", user.ID)
}

2：查询数据

func queryUser(db *gorm.DB) {
  var user User
  // 根据主键查询
  db.First(&user, 1)
  log.Printf("查询到用户: %+v", user)

  // 条件查询
  var users []User
  db.Where("age > ?", 18).Find(&users)
  log.Printf("18岁以上用户数量: %d", len(users))
}

3：更新数据

func updateUser(db *gorm.DB) {
  // 单个字段更新
  db.Model(&User{}).Where("id = ?", 1).Update("age", 21)
  
  // 多字段更新
  user := User{Name: "张三改", Age: 22}
  db.Model(&user).Where("id = ?", 1).Updates(user)
}

4：删除数据

func deleteUser(db *gorm.DB) {
  // 软删除（GORM默认）
  db.Delete(&User{}, 1)
  
  // 物理删除
  db.Unscoped().Delete(&User{}, 1)
}

五、常见问题与避坑指南

依赖缺失报错：执行go mod tidy自动补全依赖，不要手动修改go.sum文件。
连接失败：检查 MySQL 服务是否启动、DSN 中的账号密码 / 端口 / 数据库名是否正确，本地防火墙是否放行 3306 端口。
时区问题：DSN 中必须加上loc=Local，否则时间字段会出现 8 小时时差。
多 main 函数冲突：一个 Go 模块里只能有一个func main()，多个入口文件会导致编译失败。

六、总结

通过这篇文章，你已经基本掌握了 Go 语言使用 GORM 操作 MySQL 的完整流程，从环境配置、连接池设置到基础 CRUD 操作。

标签

#数据库 #mysql