您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Go 語言操作 MySQL 實戰：database/sql、mymysql 驅動與結構體映射

編輯：Java 相關知識

前言

原文標題為「Java 操作 Excel」，但內容實為 Go 語言連接 MySQL 範例。本文依實際內容重寫，提供 Go 操作 MySQL 的標準實作指南。

環境準備

# 安裝 mymysql 驅動（純 Go 實作，無 CGO 依賴）
go get github.com/ziutek/mymysql/godrv

# 或推薦：go-sql-driver/mysql（更流行、效能更好）
go get github.com/go-sql-driver/mysql

標準 database/sql 模式

package users

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql"  // 匯入驅動註冊自身
)

const (
    DBName = "myapp"
    DBUser = "user"
    DBPass = "password"
)

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Alias string `json:"alias"`
}

// 開啟連線池（非單一連線）
func OpenDB() *sql.DB {
    dsn := fmt.Sprintf("%s:%s@tcp(127.0.0.1:3306)/%s?charset=utf8mb4&parseTime=True&loc=Local",
        DBUser, DBPass, DBName)
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        panic(err)
    }
    // 連線池調整
    db.SetMaxOpenConns(25)
    db.SetMaxIdleConns(5)
    db.SetConnMaxLifetime(5 * time.Minute)
    return db
}

// 依 ID 查詢單筆
func UserByID(id int) User {
    db := OpenDB()
    defer db.Close()

    var u User
    // QueryRow 會自動掃描到結構體欄位（需順序對應或用 sqlx）
    err := db.QueryRow("SELECT id, name, alias FROM users WHERE id = ?", id).
        Scan(&u.ID, &u.Name, &u.Alias)
    if err == sql.ErrNoRows {
        return User{}  // 或回傳 error
    }
    if err != nil {
        panic(err)
    }
    return u
}

進階：使用 sqlx 簡化結構體映射

go get github.com/jmoiron/sqlx

import "github.com/jmoiron/sqlx"

func UserByIDX(db *sqlx.DB, id int) (User, error) {
    var u User
    err := db.Get(&u, "SELECT id, name, alias FROM users WHERE id = ?", id)
    return u, err  // 自動對應欄位名到結構體 tag
}

最佳實踐清單

項目	建議
驅動選擇	`go-sql-driver/mysql`（CGO 但效能最佳、維護活躍）
連線管理	全域單一 `*sql.DB` 代表連線池，不要每請求開關
參數綁定	永遠使用 `?` 佔位符，拒絕字串拼接 SQL（防注入）
錯誤處理	區分 `sql.ErrNoRows`、連線錯誤、資料錯誤，分層處理
Context 傳遞	Go 1.8+ 所有 Query/Exec 支援 `context.Context`，實現超時取消
事務	`tx, _ := db.Begin(); defer tx.Rollback(); ... tx.Commit()`
ORM 選擇	簡單專案用 `sqlx`，複雜關聯用 `GORM`/`ent`/`sqlboiler`