Golang连接数据库配置教程

Go项目直连本地MySQL或PostgreSQL需用database/sql搭配第三方驱动：MySQL用github.com/go-sql-driver/mysql，PostgreSQL用github.com/lib/pq；须显式导入（带下划线），确认服务运行、端口正确（MySQL 3306/PostgreSQL 5432）、权限开放、DSN格式无误（MySQL含tcp()、PostgreSQL加sslmode=disable），且sql.Open后必须db.Ping验证连接。

Go 项目里怎么连 MySQL（或 PostgreSQL）本地库

直接连，不绕路。Go 本身不内置数据库驱动，得靠 database/sql + 第三方驱动包组合使用。最常用的是 github.com/go-sql-driver/mysql（MySQL）和 github.com/lib/pq（PostgreSQL）。别装错包——go get 时路径必须完整，少一个斜杠都可能拉下假包。

常见错误：执行 go run main.go 报 sql: unknown driver "mysql" (forgotten import?)。这不是驱动没装，是忘了在代码里显式导入驱动包（哪怕没直接调用它的函数）：

import (
    "database/sql"
    _ "github.com/go-sql-driver/mysql" // 注意前面的下划线
)

PostgreSQL 同理，导入 _ "github.com/lib/pq"。

本地数据库服务没启动？先确认端口和权限

Mac / Linux 下用 brew services list 或 systemctl status mysql 看 MySQL 是否 running；Windows 用户打开「服务」找 MySQL80 或类似名称。默认端口：MySQL 是 3306，PostgreSQL 是 5432。如果改过，DSN 字符串里的端口必须同步改。

本地开发建议用 root 或新建专用用户，但注意权限控制：

• MySQL：确保用户有 localhost（不是 127.0.0.1）的访问权限，IPv6 下有时会出问题
• PostgreSQL：检查 pg_hba.conf 是否允许 local 或 host 连接，认证方式别设成 scram-sha-256 而不配 Go 客户端支持（lib/pq 旧版不支持）
• 密码含特殊字符？URL 编码它，比如 @ → %40，否则 DSN 解析失败

DSN 怎么写才不出错

DSN（Data Source Name）是连接字符串，格式敏感。MySQL 和 PostgreSQL 差异明显，不能混用。

MySQL 标准 DSN 示例（不含参数）：

user:password@tcp(127.0.0.1:3306)/dbname

加参数更稳妥（尤其本地开发）：

user:password@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local&timeout=30s

PostgreSQL 使用 URL 形式（注意双斜杠）：

postgres://user:password@localhost:5432/dbname?sslmode=disable

关键点：

• sslmode=disable 必加，除非你真配了本地 SSL
• MySQL 的 parseTime=true 让 time.Time 解析生效，否则日期字段读出来是字符串
• 别漏掉 tcp(...) 包裹，否则默认走 Unix socket（Linux/macOS 下路径可能不对）

Open 之后一定要 Ping，别信 defer Close

sql.Open 只是初始化连接池，并不真正拨号。很多新手写了 db, _ := sql.Open(...) 就直接查，结果第一次 Query 才报错，堆栈还藏得深。正确做法是立即 Ping：

db, err := sql.Open("mysql", dsn)
if err != nil {
    log.Fatal(err)
}
if err := db.Ping(); err != nil {
    log.Fatal("can't connect to db:", err)
}

还有两个易忽略点：

• db.Close() 应该在程序退出前调用，不是每次查询后；它关的是整个连接池
• 连接池大小默认是 0（不限），本地开发建议设限：db.SetMaxOpenConns(10)，避免误操作打爆本地库
• PostgreSQL 驱动对上下文支持较弱，QueryContext 在超时场景下不如 MySQL 稳定，本地调试时优先用 Query + db.SetConnMaxLifetime

本地跑通的关键，往往卡在 DSN 写错、服务没启、权限没开这三处。其他都是细节，但细节一错就卡半天。