PHP使用PDO连接PostgreSQL故障转移集群连接超时问题咨询

问题核心原因 #

PHP PDO的pgsql驱动默认没有覆盖libpq的默认连接超时配置，libpq默认连接超时为30秒，所以每次host1不可达时都会等待30秒才尝试下一个主机。而你的Lua脚本所用的pg驱动大概率默认内置了更小的连接超时值，所以不会出现长时间等待的问题。

最优解决方案 #

直接在你的PDO连接字符串中添加libpq原生支持的connect_timeout参数即可，不需要修改其他业务逻辑，对第三方应用侵入性为0：

"pgsql:host=host1,host2 port=5432 dbname=fusionpbx user=fusionpbx password=password target_session_attrs=read-write connect_timeout=2"

该参数指定单个主机的连接超时时间（单位为秒），设置为2秒时，host1不可达的情况下仅会等待2秒就自动切换到host2尝试连接，完全符合你的临时方案的预期，且是libpq官方支持的标准配置，比修改PDO::ATTR_TIMEOUT更可靠（PDO::ATTR_TIMEOUT实际控制的是查询超时，部分环境下会连带影响连接超时，但不是标准用法，可能影响后续正常查询的超时逻辑）。

进阶优化（解决节点不可用状态不缓存的问题） #

如果需要避免每次请求都等待2秒的连接超时，可以在应用层增加轻量的失败节点缓存：

• 用APCu或者本地文件缓存最近连接失败的节点，缓存有效期设置为10~30秒
• 每次生成DSN前先检查缓存，把最近失败的节点放到主机列表的最后，优先尝试正常节点
  该方案改动极小，不需要额外部署外部监控服务，适合第三方应用的二次修改。

原有方案的补充说明 #

• 动态调整节点顺序的方案适合规模较大的集群场景，如果你已经有成熟的PostgreSQL集群监控体系，可以继续使用该方案，稳定性更高
• 持久连接方案不推荐在第三方应用中开启，PHP-FPM进程常驻的场景下容易出现连接泄漏、连接数占满数据库连接池的问题，还可能触发未知名的事务状态异常问题

内容的提问来源于stack exchange，提问作者Łukasz Zwierko