buffalo的buffalo db命令不支持sqlite，因pop v6+彻底移除其dialect注册逻辑；仅内置支持postgres、mysql、sqlserver三种数据库，且dialect名和连接参数须严格匹配官方要求。
buffalo db 命令为什么总是报 “unknown dialect 'sqlite3'”
这不是配置写错，是 pop v6+ 官方彻底移除了 SQLite 驱动注册逻辑。你执行 buffalo db create 或 buffalo db migrate 时看到的 unknown dialect "sqlite3" 或 driver: unknown driver "sqlite3" (forgotten import?)，本质是 pop 的 dialects/ 目录下压根没有 sqlite3.go 文件 —— 即使你手动 import _ "github.com/mattn/go-sqlite3"，pop 也找不到对应的 SqliteDialect 实现。
常见错误现象：
-
database.yml写了dialect: sqlite3，但buffalo db命令完全静默忽略，或启动时报 panic - 用
DATABASE_URL=sqlite3://./dev.sqlite也无法绕过，因为 pop 初始化时就卡在 dialect 查找阶段
哪些数据库能直接用 buffalo db 命令管理
只有 pop 官方内置支持的三种：PostgreSQL、MySQL、SQL Server。它们的 dialect 名必须严格匹配：
- PostgreSQL →
dialect: postgres（不是postgresql） - MySQL →
dialect: mysql（不是mariadb，也不支持mysql8这类别名） - SQL Server →
dialect: sqlserver（注意是全小写、无横线）
参数差异直接影响连接成败：
-
postgres必须带sslmode（如sslmode=disable），否则本地开发常连不上 -
mysql的parseTime=true要显式加在url参数里，否则 time.Time 扫描失败 -
sqlserver不支持 Unix socket，host 必须是 IP 或域名
想用 buffalo db 管理 SQLite？唯一可行路径
必须降级到 pop v5 或更早版本，并手动 patch 驱动。但不推荐 —— pop v5 已停止维护，且与 Buffalo v2.x 的 module 依赖冲突严重。实际项目中，更可靠的做法是：
- 保留
buffalo db仅用于 PostgreSQL/MySQL 环境（如 CI 中用sqlite3模拟时，改用echo 'development:\n dialect: sqlite3\n database: ./test.db' > database.yml+ 手动go run -mod=mod ./scripts/migrate.go） - SQLite 场景彻底弃用 pop 迁移，改用原生
database/sql+github.com/mattn/go-sqlite3，在app.go中用sql.Open("sqlite3", "./dev.sqlite")初始化全局*sql.DB - 迁移脚本单独写成 Go 文件（如
migrate/main.go），用db.Exec()执行建表语句，不依赖buffalo db
buffalo db 在 CI 中初始化失败的典型原因
CI 流水线里 buffalo db create 报错，90% 不是数据库问题，而是环境没对齐：
- 没设
BUFFALO_ENV=test，导致它去读database.yml的development块，而该块可能含本地路径或密码变量 - 没运行
go mod download，buffalo 内部动态 import pop 模块时失败，表现为cannot find package "github.com/gobuffalo/pop/v6" - PostgreSQL 容器未就绪就执行
buffalo db create，应加等待逻辑（如pg_isready -h localhost -U postgres）
SQLite 的内存模式 :memory: 在 Buffalo 热重载下不可用 —— 每次代码变更重建连接，数据就丢了，必须用磁盘文件路径。
