MySQL服务需预先启动并验证可连接，Go需引入github.com/go-sql-driver/mysql驱动，DSN须URL编码且含charset=utf8mb4和parseTime=True，必须调用db.Ping()测试连接，并合理配置连接池与context超时。
确认 MySQL 服务已运行且可被 Go 进程访问
Go 本身不自带数据库服务，mysql 必须是本地或远程已启动的实例。常见错误是执行 go run main.go 后报错 dial tcp 127.0.0.1:3306: connect: connection refused——这说明 MySQL 没在监听默认端口。
- macOS 上用
brew services start mysql或打开 MySQL 官方安装包的 Preference Pane 启动服务 - Linux 常用
sudo systemctl start mysql（Ubuntu/Debian）或sudo systemctl start mysqld（CentOS/RHEL） - Windows 用户若用 MySQL Installer，需在「Configuration」里勾选“Start the MySQL Server at System Startup”
- 验证方式：终端运行
mysql -u root -p能登录即表示服务就绪；若提示command not found，需把/usr/local/mysql/bin（macOS）或C:\Program Files\MySQL\MySQL Server X.X\bin（Windows）加进$PATH或%PATH%
选择并初始化正确的 Go MySQL 驱动
Go 官方没有内置 MySQL 驱动，必须显式引入第三方实现。database/sql 是接口层，真正干活的是驱动，目前主流且维护活跃的是 github.com/go-sql-driver/mysql。
- 执行
go get -u github.com/go-sql-driver/mysql安装驱动（Go 1.16+ 默认启用GO111MODULE=on，无需手动go mod init） - 代码中只需
import _ "github.com/go-sql-driver/mysql"（下划线导入，触发init()注册驱动），不用直接调用其导出函数 - 别误用已归档的
github.com/Go-SQL-Driver/MySQL（大小写错误）或过时的github.com/satori/go.uuid类间接依赖库 - 如果项目用了
go.work或多模块结构，确保go.mod文件里包含该驱动的正确版本（如v1.7.1），避免因缓存导致旧版行为异常
构建 DSN 字符串时注意特殊字符与编码
连接字符串（DSN）格式为 user:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True，其中任何字段含特殊字符（如 @、/、?）都必须 URL 编码。
- 密码含
@时，要用url.QueryEscape处理，例如url.QueryEscape("p@ss/w0rd")→p%40ss%2Fw0rd -
charset=utf8mb4是必须项，否则中文插入可能变???；parseTime=True才能让time.Time正确解析DATETIME字段 - 避免硬编码 DSN 到
main.go，改用环境变量：读取os.Getenv("DB_DSN")，再通过go run -ldflags="-X 'main.dsn=${DB_DSN}'" main.go注入（适合 CI/CD）或用godotenv加载.env - 测试连接是否有效，不要只靠
sql.Open——它不真正建连；要加db.Ping()，否则可能延迟到第一次Query才暴露认证失败
处理连接池与上下文超时避免资源泄漏
Go 的 *sql.DB 是连接池抽象，不是单个连接。没设限或没关池，长期运行的服务容易耗尽 MySQL 的 max_connections。
立即学习“go语言免费学习笔记（深入）”；
- 设置
db.SetMaxOpenConns(25)和db.SetMaxIdleConns(25)（值按业务 QPS 调整，25 是较安全起点） - 所有数据库操作必须传入带超时的
context.Context，例如ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)，再传给db.QueryContext(ctx, ...) - 别在 HTTP handler 里反复
sql.Open——每次都会新建池；应全局复用一个*sql.DB实例，在main()初始化后注入到 handler 依赖中 - 程序退出前调用
db.Close()，否则进程可能卡在未释放的连接上（尤其在测试中用defer db.Close()容易漏掉）
db.Ping() 成功且能查出一行数据，后续开发就只是写 SQL 和映射 struct 的事了。 
