Buffalo项目连不上开发数据库主因是models.NewDB()未获取有效URL，因config/database.yml根本不被解析；需检查DATABASE_URL环境变量或硬编码URL是否正确，并确认PostgreSQL服务已启动且端口可达。
Buffalo 项目连不上开发数据库，90% 是因为 models.NewDB() 没拿到有效连接 URL，而不是 config/database.yml 写得不对——那个 YAML 文件根本不会被自动读取。
为什么改了 database.yml 却没用
Buffalo 默认不解析 config/database.yml。它只是个占位模板，常被误当成 Rails 那样“开箱即用”的配置源。实际起作用的是 models/models.go 中 NewDB() 函数返回的 pop.Connection 实例。
-
NewDB()通常直接拼接os.Getenv("DATABASE_URL")或硬编码字符串（如"postgres://..."） - 如果你只改了
database.yml但没导出DATABASE_URL，或没更新硬编码 URL 中的密码/端口，连接必然失败 - 执行
echo $DATABASE_URL，如果输出为空，说明环境变量根本没生效
怎么让 models.NewDB() 连上本地 PostgreSQL
最稳妥的做法是显式构造 URL 并传给 pop.NewConnection()，避免依赖环境变量漂移：
- 打开
models/models.go，找到NewDB()函数 - 把原来类似
pop.Connection{URL: os.Getenv("DATABASE_URL")}的逻辑，替换成硬编码（仅限开发）：pop.Connection{ URL: "postgres://postgres:yourpass@localhost:5432/myapp_development?sslmode=disable", } - 确保
dialect字段不出现——pop从 URL scheme 自动推断，写错dialect: "postgres"反而可能干扰驱动匹配 - PostgreSQL 密码含特殊字符（如
@、/）时，必须用url.PathEscape处理，否则解析失败
执行 buffalo db create -a 报 “connection refused” 怎么排查
这个错误和 Buffalo 配置无关，只说明 TCP 连接层不通——先确认数据库服务本身是否就绪：
- 运行
pg_isready -h localhost -p 5432（PostgreSQL）或mysqladmin ping -h 127.0.0.1 -P 3306 -u root -p（MySQL），验证服务进程与端口 - 用
ps aux | grep postgres或systemctl status postgresql确认进程在运行 - 检查 PostgreSQL 的
pg_hba.conf是否允许local或host连接，尤其注意md5认证方式是否启用 - 别用
host: "localhost"连 MySQL：Unix socket 路径解析容易失败，强制写host: "127.0.0.1"
多环境切换时最容易忽略的点
GO_ENV 必须在 buffalo dev 或 buffalo build 执行前导出，不是运行时设的——它只影响编译期中间件注入（比如 development 下才加 logger），但不影响数据库连接逻辑。
-
GO_ENV=production buffalo build不会自动去读database.yml的production:块 - 真正决定连哪个库的，还是
NewDB()里写的 URL 或DATABASE_URL值 - Docker 部署时，务必在
Dockerfile里写ENV GO_ENV=production，而不是指望docker run -e GO_ENV=production——后者对构建无意义
复杂点在于：Buffalo 把“配置管理”和“连接初始化”拆成了两件事。你得同时管好 shell 环境变量、Go 代码里的 URL 构造、以及底层数据库服务状态——三者缺一不可，且任一环节出问题，报错信息都指向“连接失败”，但根因完全不同。
