如何在 Go 中使用 MySQL 驱动动态创建数据库

本文详解如何在 go 应用启动时，不依赖预设数据库名，通过 database/sql 和 go-sql-driver/mysql 动态创建 mysql 数据库及表结构，解决连接字符串强制要求 dbname 的常见痛点。

本文详解如何在 go 应用启动时，不依赖预设数据库名，通过 database/sql 和 go-sql-driver/mysql 动态创建 mysql 数据库及表结构，解决连接字符串强制要求 dbname 的常见痛点。

在 Go 中操作 MySQL 时，sql.Open() 的 DSN（数据源名称）通常形如 “user:pass@tcp(localhost:3306)/dbname?charset=utf8″，其中 /dbname 是必需的——但若目标数据库尚不存在，该连接将直接失败。关键在于：MySQL 允许在未指定数据库的情况下建立连接，只要 DSN 中省略数据库名即可。此时连接默认指向 MySQL 实例的根上下文，可执行 CREATE DATABASE if NOT EXISTS … 等全局管理语句。

✅ 正确做法：分两步完成初始化

1. 使用无数据库名的 DSN 建立初始连接
   去掉 DSN 中的 /dbname 部分，保留协议、地址和参数：

   // 注意：末尾不带数据库名，且必须保留 ? 后的参数（如 charset） dsn := "root:password@tcp(127.0.0.1:3306)/?charset=utf8mb4&parseTime=True&loc=Local" db, err := sql.Open("mysql", dsn) if err != nil {     log.Fatal("无法打开数据库连接（无库名）:", err) } defer db.Close()  // 必须 Ping 以验证连接有效性 if err := db.Ping(); err != nil {     log.Fatal("数据库连接失败:", err) }

2. 执行 CREATE DATABASE 语句
   使用 db.Exec() 创建数据库（推荐加 IF NOT EXISTS 避免重复报错）：

   dbName := "myapp_db" _, err := db.Exec(fmt.Sprintf("CREATE DATABASE IF NOT EXISTS `%s` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci", dbName)) if err != nil {     log.Fatal("创建数据库失败:", err) }

3. 重新以新数据库名打开连接并建表
   此时可安全构造含数据库名的 DSN，并初始化业务表：

   fullDSN := fmt.Sprintf("root:password@tcp(127.0.0.1:3306)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbName) db, err := sql.Open("mysql", fullDSN) if err != nil {     log.Fatal("无法连接目标数据库:", err) } defer db.Close()  // 创建示例表 createTableSQL := ` CREATE TABLE IF NOT EXISTS users (     id BIGINT PRIMARY KEY AUTO_INCREMENT,     name VARCHAR(100) NOT NULL,     created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB;` _, err = db.Exec(createTableSQL) if err != nil {     log.Fatal("创建表失败:", err) }

⚠️ 注意事项与最佳实践

• 权限要求：执行 CREATE DATABASE 的 MySQL 用户需具备 CREATE 权限（如 GRANT CREATE ON *.* TO ‘user’@’%’），生产环境切勿使用 root。
• 字符集与排序规则：建议显式指定 utf8mb4 及 utf8mb4_unicode_ci，避免 emoji 或四字节 UTF-8 字符存储异常。
• 错误处理不可省略：sql.Open() 仅校验 DSN 格式，必须调用 db.Ping() 确认网络与认证可达。
• 连接池管理：首次 sql.Open() 的连接应 defer db.Close()，但后续业务连接需独立管理生命周期。
• 幂等性设计：始终使用 IF NOT EXISTS，确保服务多次启动不会因数据库已存在而中断。

通过以上流程，Go 应用即可实现数据库“按需自举”，显著提升部署自动化程度与开发体验。