使用 golang 连接 mysql 的关键在于理解驱动安装、dsn 构造、连接检查和常见错误处理。1. 安装 go-sql-driver/mysql 并正确导入，确保驱动注册；2. 构造正确的 dsn，注意格式、协议、参数配置；3. 使用 ping() 检查连接，并设置合适的连接池大小；4. 常见错误如 dsn 格式错误、连接被拒绝、权限问题等需逐一排查。
刚学 Golang 的时候，操作数据库是个绕不开的坎。很多人一开始都会遇到“怎么连数据库”、“为什么总是报错”这样的问题。其实用标准库
database/sql连接 MySQL 并不难，关键是要理解几个核心点，避免踩坑。
1. 安装驱动和基本导入
Go 的
database/sql是一个接口层，它本身并不包含具体的数据库实现，所以连接 MySQL 需要额外安装对应的驱动。最常用的是
go-sql-driver/mysql。
安装命令：
立即学习“go语言免费学习笔记（深入）”；
go get -u github.com/go-sql-driver/mysql
然后在代码中导入：
import (
"database/sql"
_ "github.com/go-sql-driver/mysql"
)注意那个下划线
_，它表示只执行驱动的 init 函数，用来注册这个驱动，这一步是必须的。
2. 正确构造 DSN（数据源名称）
连接数据库的第一步就是写对 DSN（Data Source Name），也就是连接字符串。格式如下：
user:password@tcp(host:port)/dbname?charset=utf8mb4&parseTime=True&loc=Local
举个例子：
dsn := "user:pass@tcp(127.0.0.1:3306)/mydb?charset=utf8mb4&parseTime=True&loc=Local"
db, err := sql.Open("mysql", dsn)这里有几个容易出错的地方需要注意：
- 用户名、密码、主机、端口、数据库名都要正确。
- 千万别漏了协议
tcp()
，否则会报错。 - 参数部分不是必须的，但建议加上
parseTime=True
，这样可以把时间字段自动转成time.Time
类型。 - 如果你处理中文，
charset=utf8mb4
很重要，utf8 在 MySQL 里只是三个字节的版本。
3. 检查连接是否成功
调用
sql.Open只是初始化了一个连接池，并不会立即连接数据库。如果你想知道当前是否能正常连上，需要手动调用
Ping()方法：
err = db.Ping()
if err != nil {
log.Fatal("无法连接数据库：", err)
}这一步特别适合在程序启动时做健康检查，或者调试连接失败的问题。
另外，记得设置最大连接数和空闲连接数，尤其是在高并发场景下：
db.SetMaxOpenConns(20) db.SetMaxIdleConns(10)
默认值可能太小，容易出现连接不够的情况。
4. 常见错误及解决方法
新手在连接数据库时经常会遇到一些错误，比如：
- invalid DSN：说明连接字符串格式不对，仔细检查用户名、密码、host 和 port。
- connection refused：可能是数据库没启动，或者防火墙拦住了端口。
- access denied：用户权限配置有问题，确认用户有远程访问权限（如果是跨服务器）。
-
unknown driver "mysql"：忘记导入驱动或导入方式不对（没加
_
）。
如果不确定哪里出错了，可以先用 MySQL 客户端工具手动测试连接，排除网络或账号问题。
基本上就这些。刚上手的时候可能会觉得步骤多，但只要理清逻辑，每一步都很容易掌握。关键是把 DSN 写对，驱动引入正确，再配合 Ping 检查连接状态，大部分问题都能搞定。
