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 字符串里的端口必须同步改。
立即学习“go语言免费学习笔记(深入)”;
本地开发建议用 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 示例(不含参数):
SmartB2B 是一款基于PHP、MySQL、Smarty的B2B行业电子商务网站管理系统,系统提供了供求模型、企业模型、产品模型、人才招聘模型、资讯模型等模块,适用于想在行业里取得领先地位的企业快速假设B2B网站,可以运行于Linux与Windows等多重服务器环境,安装方便,使用灵活。 系统使用当前流行的PHP语言开发,以MySQL为数据库,采用B/S架构,MVC模式开发。融入了模型化、模板
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 写错、服务没启、权限没开这三处。其他都是细节,但细节一错就卡半天。









