buffalo连接postgresql必须显式配置host、port、sslmode等关键参数，database_url环境变量会完全覆盖database.yml，且sslmode未正确设置是连接失败最常见原因。
Buffalo 默认支持 PostgreSQL，但必须显式配置连接参数，不能只靠 database.yml 中的 dialect: "postgres" 就认为连上了——漏掉 sslmode 或环境变量覆盖会导致连接拒绝或静默失败。
database.yml 里必须填全关键字段
Buffalo 的 database.yml 不是模板，而是运行时直接读取的配置源。PostgreSQL 连接失败最常见的原因是字段缺失或值非法：
-
host和port必须显式写，不能依赖默认（localhost:5432很多时候不成立，尤其 Docker 或远程实例） -
sslmode必须明确设为disable、require或verify-full；本地开发常用disable，但生产环境多数 PostgreSQL 实例强制require -
url字段优先级高于其他字段；如果同时写了url和host/database等，url会完全覆盖其余配置 - 密码含特殊字符（如
@、/）必须 URL 编码，否则解析失败
示例（开发环境）：
development: dialect: "postgres" database: "myapp_development" user: "postgres" password: "password" host: "localhost" port: 5432 sslmode: "disable" pool: 10 idle_timeout: 180
DATABASE_URL 环境变量会彻底绕过 database.yml
Buffalo 启动时优先检查 DATABASE_URL 环境变量。只要它存在，database.yml 中所有字段都会被忽略——包括 sslmode。这是最常被踩的坑。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 检查是否在
.env文件或 shell 中误设了DATABASE_URL（例如旧项目残留） - 若要用
DATABASE_URL，必须把sslmode写进 URL 末尾：postgres://user:pass@host:port/db?sslmode=disable - 用
buffalo task db:status可验证当前实际使用的连接串（输出里会显示解析后的 URL）
连接池参数影响并发行为，不是可选项
Buffalo 自动生成的 database.yml 里 pool 默认是 5，这在本地调试够用，但一上压测或生产就立刻暴露问题：
- PostgreSQL 默认
max_connections通常为 100；若 Buffalo 应用开 10 个实例，每个pool: 5，就占掉 50 个连接，再加其他服务很容易打满 -
idle_timeout设太长（比如 300 秒）会导致空闲连接长期挂起，PostgreSQL 侧可能因超时主动断连，Buffalo 却不自动重连，后续请求报server closed the connection unexpectedly - 建议：开发用
pool: 5+idle_timeout: 180；预发/生产按实例数和 QPS 调整，常见值是pool: 20+idle_timeout: 60
迁移命令执行前务必确认连接可用
buffalo db migrate 不会提前校验数据库连通性，它直接尝试建表或执行 SQL —— 一旦连接失败，错误信息往往模糊（如 failed to open database: pq: dial tcp: lookup localhost: no such host），容易误判为 SQL 语法问题。
- 先手动运行
psql -h localhost -U postgres -d myapp_development验证基础连通性 - 确保
pg_hba.conf允许对应用户从对应 host 连接（尤其 Docker 场景下 host 常是host.docker.internal而非localhost） - 若用
buffalo db migrate -e production，要确认production区块在database.yml中完整且无拼写错误（比如写成prodution就静默 fallback 到 development）
真正麻烦的点不在配置格式，而在于 Buffalo 对环境变量和配置文件的加载顺序、以及 PostgreSQL 自身的 SSL 和连接池策略之间存在隐式耦合——漏掉任意一层，表现都是“连不上”，但原因可能差十倍远。
