主机名解析多IP时libpq的行为及PostgreSQL主节点连接验证

• 核心结论：只要保留targetServer=primary参数，libpq的行为会和之前完全一致，会逐个尝试DNS返回的所有IP，直到找到并连接到主节点。

• 具体细节说明：

  1. libpq对多IP的处理逻辑：当连接字符串中的主机名解析出多个IP地址时，libpq会严格按照DNS返回的顺序逐个尝试建立TCP连接，这和你之前直接在连接串里写多个IP的行为完全相同。
  2. targetServer=primary的筛选作用：不管是通过IP列表还是DNS解析的多IP，这个参数都会让libpq在成功建立TCP连接后，检查该PostgreSQL节点的角色。如果是备节点，libpq会立即断开这个连接，继续尝试下一个IP，直到找到主节点为止。
  3. TLS验证的前提：因为所有节点共享同一个主机名和证书，只要证书的主体（CN）或者SAN扩展包含my_awesome_hostname，TLS握手就能正常通过，不会出现证书不匹配的错误，这是整个方案能正常工作的必要条件。

• 验证建议：如果想确认行为是否符合预期，可以让客户端设置环境变量PGDEBUG=5，启动应用后查看libpq的调试日志，能清晰看到逐个尝试IP、检查节点角色并最终连接主节点的完整过程。

内容的提问来源于stack exchange，提问作者PhoenixPerson