Buffalo连不上MySQL主因是MySQL驱动未注册或DATABASE_URL格式错误。需在models/models.go中import _ "github.com/go-sql-driver/mysql",并设DATABASE_URL为mysql://user:pass@127.0.0.1:3306/db?parseTime=true。

Buffalo 连不上 MySQL,八成是驱动没注册或连接串格式错——不是配置写得不对,而是根本没让 Go 知道“mysql”这个 driver 存在。
panic: unknown driver "mysql" 怎么修
这是最常卡住的第一步。Buffalo 的 pop 层默认只加载 postgres 和 sqlite3 驱动,MySQL 必须手动注册。
- 在
models/models.go顶部的import块里加一行:import _ "github.com/go-sql-driver/mysql" - 确保这行在
"github.com/gobuffalo/pop/v6"之前或同级,不能放在actions/或其他地方 - 删掉
go.mod里任何重复的 mysql 驱动引用(比如mattn/go-sqlite3混在里面会干扰) - 执行
go mod tidy后,再跑buffalo dev;如果还 panic,说明 import 没生效,检查文件路径和拼写
database.yml 写对了但还是连不上
database.yml 不是 Buffalo 启动时读取的唯一配置源,它只在 pop.Open() 被显式调用且没传 url 时才 fallback 使用。真正起作用的是 url 字段或环境变量 DATABASE_URL。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
url字段必须存在,且格式严格:root:pass@tcp(127.0.0.1:3306)/myapp?parseTime=true&loc=Local -
parseTime=true是硬性要求,否则time.Time字段扫描失败,不报错但值为零时间 -
loc=Local避免时区错乱,尤其当 MySQL 的time_zone是SYSTEM且系统时区非 UTC 时 - 密码含
@、/、:等字符,必须 URL 编码,例如pass@word→pass%40word - 别依赖
user/password等单独字段:只要url存在,它们全被忽略
用 buffalo db migrate 前必须确认三件事
buffalo db migrate 不是万能命令,它只认已注册驱动 + 正确 URL + 已存在的数据库名。漏一步就卡住不动或报错。
- 先验证驱动是否真注册:运行
buffalo task db:info,输出中Dialect应为mysql,Transaction Support为true - 再确认库是否存在:执行
buffalo pop create -a,成功输出created database myapp_development才算过关 - 最后跑迁移:
buffalo db migrate up;若报connection refused,不是密码错,是 MySQL 服务根本没起来,或host填了localhost导致走 Unix socket(建议统一用127.0.0.1) - 注意:migration 文件必须放
models/migrations/下,且命名含时间戳前缀(如20261025143022_add_email.up.fizz),否则静默跳过
DATABASE_URL 环境变量比 database.yml 更可靠
很多团队绕过 database.yml 直接用环境变量,因为 Buffalo 实际加载逻辑更依赖 os.Getenv("DATABASE_URL"),尤其在 CI 或容器环境中。
- 导出变量:
export DATABASE_URL="mysql://root:pass@127.0.0.1:3306/myapp_development?parseTime=true" - 同时导出
GO_ENV=development,否则models.NewDB()可能误读配置块 - 验证是否生效:
echo $DATABASE_URL和buffalo task db:ping(需提前go install github.com/gobuffalo/pop/v6/cmd/pop@latest) -
database.yml在这种模式下只是占位文件,改它完全不影响运行时行为
最容易被忽略的点:MySQL 驱动注册必须发生在 pop.Open() 之前,且 import 语句不能被条件编译(如 // +build !test)屏蔽;哪怕只差这一行,整个数据库层就形同虚设。

















