Go语言操作MySQL数据库：原生SQL与GORM实战对比

结果与目标：建立稳定的数据库连接

在进行任何数据库操作前，首要任务是确保能够成功连接到 MySQL 服务。无论是使用原生驱动还是 GORM，都需要提供准确的数据源名称（DSN），包含用户名、密码、主机地址、端口及数据库名。

准备条件：环境安装与依赖

在执行以下代码示例前，请确保已完成以下准备工作：

• 安装 Go 语言运行环境，并确保 GOPATH 或 Go Modules 配置正确。
• 确保目标 MySQL 服务器正在运行，且拥有可访问的用户权限。
• 原生 SQL 方式：需安装 MySQL 驱动：
  go get -u github.com/go-sql-driver/mysql
• GORM 方式：需安装 GORM 核心库及 MySQL 驱动：
  go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql
  注：原文使用的是旧版 gorm v1 (github.com/jinzhu/gorm)，建议新项目采用最新的 gorm v2 以获取更好的支持和安全性，但下文将基于原文逻辑保留经典用法说明。

真实操作顺序：原生 SQL 查询流程

原生方式使用 database/sql 包，适合对 SQL 有精细控制需求或追求极致性能的场合。

第1步：初始化连接与错误处理

调用 sql.Open 仅验证网络连通性，不立即创建连接池。务必检查返回的 err 并使用 db.Close() 释放资源。

package main

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    // 替换为您的实际连接字符串
    db, err := sql.Open("mysql", "username:password@tcp(host:port)/dbname")
    if err != nil {
        panic(err.Error())
    }
    defer db.Close()

    // 测试连接是否有效
    if err = db.Ping(); err != nil {
        panic(err.Error())
    }
    fmt.Println("Connected to database successfully!")
}

第2步：执行查询与结果遍历

使用 db.Query 执行 SELECT 语句。由于 SQL 列数动态变化，需先获取列名，再动态分配扫描参数数组 scanArgs，最后通过 rows.Scan 逐行读取数据。

    rows, err := db.Query("SELECT * FROM table_name")
    if err != nil {
        panic(err.Error())
    }
    defer rows.Close()

    columns, err := rows.Columns()
    if err != nil {
        panic(err.Error())
    }

    // 动态生成扫描参数
    values := make([]sql.RawBytes, len(columns))
    scanArgs := make([]interface{}, len(values))
    for i := range values {
        scanArgs[i] = &values[i]
    }

    for rows.Next() {
        err = rows.Scan(scanArgs...)
        if err != nil {
            panic(err.Error())
        }

        // 输出每列数据
        for i, col := range values {
            if col == nil {
                fmt.Print(columns[i], ": NULL\t")
            } else {
                fmt.Print(columns[i], ": ", string(col), "\t")
            }
        }
        fmt.Println()
    }
    // 检查循环过程中的错误
    if err = rows.Err(); err != nil {
        panic(err.Error())
    }

真实操作顺序：GORM ORM 操作流程

GORM 提供了类似 ActiveRecord 的模式，极大地简化了 CRUD 操作和表结构迁移。

第1步：定义模型与自动迁移

定义 Go 结构体，GORM 会根据结构体标签自动映射到数据库表字段。使用 AutoMigrate 可自动创建或更新表结构，适用于开发阶段快速迭代。

type Product struct {
    ID    uint   `gorm:"primaryKey"`
    Code  string `gorm:"uniqueIndex"`
    Price uint
}

// 注意：旧版 gorm.Model 包含 ID, CreatedAt, UpdatedAt, DeletedAt
// 在新版 gorm 中推荐显式定义或使用 gorm.DeletedAt

第2步：执行 CRUD 操作

GORM 通过链式调用完成复杂的数据库操作，无需手动拼接 SQL。

// 连接数据库
// 新版连接示例：db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
// 兼容旧版写法（如原文）：
db, err := gorm.Open("mysql", "username:password@tcp(host:port)/dbname?charset=utf8&parseTime=True&loc=Local")
if err != nil {
    panic("failed to connect database")
}
defer db.Close()

// 自动迁移 Schema
db.AutoMigrate(&Product{})

// Create: 插入数据
product := Product{Code: "L1212", Price: 1000}
db.Create(&product)

// Read: 查询数据
var result Product
db.First(&result, 1)                 // 根据主键查找
// db.First(&result, "code = ?", "L1212") // 根据条件查找

// Update: 更新数据
db.Model(&result).Update("Price", 2000)

// Delete: 删除数据 (软删除)
db.Delete(&result)

完成判断与排错指南

操作成功的标志是程序无报错输出，且数据库中数据状态符合预期（新增、修改或删除）。常见问题排查如下：

• 连接失败：检查 DSN 字符串中的用户名、密码、IP 地址是否正确，MySQL 服务是否监听指定端口。
• 编码问题：在连接字符串中确保添加 charset=utf8mb4 和 parseTime=True，以正确处理中文和日期时间类型。
• 权限不足：确认用户具有对应数据库的 SELECT, INSERT, UPDATE, DELETE 权限。
• GORM 版本差异：若使用最新版 GORM，请注意 API 的变化，如 First 的参数形式和默认行为可能与旧版略有不同。

简要总结

对于小型脚本或对 SQL 有特殊优化的场景，原生 database/sql 是轻量级且高效的选择；而对于中大型项目，GORM 能显著提升开发效率并降低 SQL 注入风险，同时提供强大的迁移管理能力。开发者应根据项目规模和维护成本权衡选择。以上就是 Go语言操作MySQL数据库：原生SQL与GORM用法详解的详细内容，更多关于Go语言数据库操作技术的资料请关注本站其它相关文章！