Laravel Sail连接DigitalOcean PostgreSQL首条查询耗时5秒排查

本地基于Laravel Sail（Docker）运行的Laravel/React应用连接本地数据库时，所有查询耗时均在毫秒级；连接部署在DigitalOcean的PostgreSQL数据库时，页面第一条查询固定耗时约5秒，后续查询速度恢复正常。使用DBeaver直连该远程数据库时，建连、查询均无延迟，耗时为毫秒级。

• PostgreSQL反向DNS解析超时：PostgreSQL默认会对所有接入连接的客户端IP做反向DNS查找，匹配pg_hba.conf中的主机名权限规则。如果Laravel Sail所在Docker容器的出口IP没有配置反向PTR记录，或DNS查询链路不通，会触发默认5秒的DNS查询超时，超时后PostgreSQL才会跳过主机名校验放行连接。DBeaver运行在宿主机，出口IP通常已被DNS缓存或有合法PTR记录，因此不会触发该问题。
• SSL连接协商重试超时：DigitalOcean托管PostgreSQL默认强制SSL加密连接，如果Laravel的pgsql连接配置未明确指定SSL模式，PDO扩展会先尝试发起明文连接，被服务端拒绝后再重试SSL握手，中间的等待、重试逻辑累计耗时刚好接近5秒。DBeaver默认会自动适配服务端SSL要求，首次握手即走SSL协议，无重试开销。
• Docker容器IPv6连接超时：Sail默认的Docker网桥可能开启了IPv6优先级，解析数据库域名时会优先尝试连接返回的IPv6地址，但容器到DO数据库的IPv6路由通常不通，等待5秒连接超时后才会回退到IPv4建连。宿主机上的DBeaver要么IPv6路由正常，要么默认优先IPv4，因此无该问题。
• 读写分离配置异常：如果Laravel数据库配置开启了读写分离，但配置的读库地址网络不通或权限不足，框架首次请求时会优先尝试连接读库，触发5秒连接超时后才会fallback到写库执行查询，和“超时后切换执行路径”的推测完全吻合。

• 先定位延迟阶段：临时将.env中的DB_HOST改为DO数据库的IPv4直连地址（跳过域名解析），同时在config/database.php的pgsql配置中添加PDO::ATTR_TIMEOUT => 2将连接超时设为2秒，如果此时首查延迟同步缩短到2秒，可100%确认延迟发生在数据库建连阶段，和SQL语句本身性能无关。
• 排查IPv6/域名解析问题：进入Sail应用容器内部，直接用容器内的psql客户端尝试连接远程数据库并计时：
  1. 如果容器内psql连接同样卡5秒，先执行ping6 <数据库域名>检查IPv6连通性，若IPv6不通，可修改容器内/etc/gai.conf将IPv4优先级调高，或在docker-compose配置中关闭容器IPv6栈，改完后重试连接看延迟是否消失。
• 排查反向DNS问题：登录DO托管PostgreSQL的参数配置页，开启连接日志（log_connections = on），查看新连接日志中是否存在reverse DNS lookup failed类报错，如果存在可直接修改PostgreSQL配置将pg_hba.conf中的连接规则改为hostnossl（跳过反向DNS校验），或为Sail出口IP配置合法反向PTR记录。
• 排查SSL配置问题：修改config/database.php中pgsql连接的SSL参数，明确指定SSL模式为强制，避免明文连接重试：

'pgsql' => [
    // 其余原有配置保持不变
    'sslmode' => 'require',
    'options' => [
        PDO::ATTR_TIMEOUT => 3,
    ],
],

• 排查读写分离配置：如果开启了读写分离，临时注释读库配置，强制所有查询走写库，若首查延迟消失，说明读库地址、权限或网络配置存在问题。

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