必须显式安装对应数据库go驱动并正确导入，否则报“unknown dialect”或“driver: unknown driver”；dialect仅支持"postgres"、"mysql"、"sqlite3"、"cockroach"，需在models/models.go中用_空导入驱动（如"github.com/lib/pq"），并执行go mod tidy补全依赖。
Buffalo 本身不自带数据库驱动，必须显式安装对应数据库的 Go 驱动，并确保 pop 能加载它；否则 buffalo db migrate 或 app.Pop() 会报 “unknown dialect” 或 “driver: unknown driver” 错误。
确认 database.yml 中的 dialect 是否被 pop 支持
dialect 字段必须严格匹配 pop 内置驱动名：只能是 "postgres"、"mysql"、"sqlite3" 或 "cockroach"。写成 "postgresql"、"pgsql"、"mariadb" 都会导致连接器找不到驱动。
常见错误现象：
failed to open connection: unknown dialect "postgresql"panic: driver: unknown driver "mysql" (forgotten import?)
原因不是配置写错，而是对应驱动没被 import 进项目。
在 models/models.go 中导入对应数据库驱动
Buffalo 默认生成的 models/models.go 文件里只 import 了 github.com/gobuffalo/pop/v6，但没 import 具体驱动。你必须手动加一行：
PostgreSQL：
import _ "github.com/lib/pq"
MySQL：
import _ "github.com/go-sql-driver/mysql"
SQLite3（注意需系统有 gcc）：
import _ "modernc.org/sqlite"
⚠️ 必须用 _ 空导入，否则驱动不会注册到 database/sql；且必须放在 pop import 之后、init() 函数之前。
执行 go mod tidy 补全依赖
驱动 import 后，go mod tidy 会自动拉取对应模块。不运行这步，buffalo dev 或 buffalo db migrate 会因找不到依赖而 panic。
验证是否成功：
- 运行
go list -f '{{.Deps}}' . | grep pq（PostgreSQL 场景），应输出包含github.com/lib/pq - 启动服务时若不再报 driver 相关 panic，说明驱动已就位
如果用的是 MySQL 且本地是 macOS ARM64，注意 go-sql-driver/mysql 不依赖 cgo，可跳过编译问题；但 SQLite3 在某些 M1/M2 环境下仍可能因 modernc.org/sqlite 编译失败而中断构建——此时建议换用 PostgreSQL 避坑。
database.yml 配置与驱动必须协同生效
即使驱动装好了，database.yml 里字段填错照样连不上。关键点：
-
host填localhost对 PostgreSQL 没问题，但 MySQL 建议填127.0.0.1，避免 Unix socket 解析失败 -
port必须和真实数据库监听端口一致（PostgreSQL 默认5432，MySQL 默认3306） -
sslmode是 MySQL 专属字段，PostgreSQL 用sslmode+sslcert等组合，填错会导致连接挂起而非报错
最容易被忽略的是：驱动 import 和 dialect 名称必须完全对应，且 go mod tidy 必须执行——三者缺一，数据库支持就算“装了”也等于没装。
