自托管Next.js 13 API路由调用私有PHP API响应缓慢问题排查

问题背景 #

• 直接用Postman调用PHP API，响应耗时约100ms
• 通过自托管Next.js 13的API路由代理转发请求，首次响应耗时约1000ms（是直接调用的10倍），同一上下文内二次请求仅约20ms
• 排除Next.js冷启动（自托管Node.js架构），且代理调用公开API（Rick and Morty）时，Next.js和Postman耗时一致（约40ms），推测问题出在PHP API侧

排查建议 #

1. 检查PHP API的连接初始化耗时 #

• 排查PHP代码中是否存在首次请求时才初始化的资源（如数据库连接、Redis连接、第三方服务连接），这类初始化操作通常耗时较长
• 在PHP关键节点用microtime(true)记录时间戳并输出到日志，对比首次、二次请求的各阶段耗时，定位慢执行环节
• 确认是否启用连接池：比如数据库连接是否使用持久化配置（如PDO的PDO::ATTR_PERSISTENT），首次请求需新建连接，二次请求复用已有连接会大幅提速

2. 分析HTTP层面的差异 #

• 对比Postman与Next.js代理发送的请求头：Next.js可能发送了额外头信息，或缺少PHP API期望的头，导致PHP端额外处理耗时
• 排查DNS解析延迟：Next.js服务器首次请求PHP API时可能需要DNS解析，而Postman可能缓存了结果；可在PHP服务器hosts文件添加Next.js服务器IP映射，或在Next.js请求中直接指定IP而非域名测试
• 检查TCP连接状态：首次请求需完成TCP三次握手，二次请求复用HTTP keep-alive连接；可在PHP端通过$_SERVER['HTTP_CONNECTION']查看Next.js是否启用keep-alive，同时检查Nginx/Apache等Web服务器的keep-alive配置是否正确

3. 检查PHP运行环境的缓存机制 #

• 确认OPcache是否开启：OPcache会缓存PHP脚本字节码，首次请求需编译脚本，二次请求直接读取缓存；通过phpinfo()查看OPcache状态，确保opcache.enable=1，若为CLI模式运行PHP服务，需同时开启opcache.enable_cli=1
• 排查其他缓存（如APC、Redis缓存）：首次请求缓存未命中需生成数据，二次请求直接读取缓存，这也会导致耗时差异

4. 服务器资源瓶颈排查 #

• 查看PHP服务器的CPU、内存、磁盘IO状态：首次请求时是否存在资源竞争（如其他进程占用CPU，导致PHP进程无法及时处理）
• 检查PHP-FPM配置：确认pm.max_children、pm.start_servers等参数是否合理，首次请求可能需要启动新的FPM进程，引发延迟；开启FPM慢日志（配置slowlog），记录耗时超过阈值的请求

5. 代理请求的配置优化 #

• 检查Next.js代理请求的配置：是否启用HTTP/2，是否设置合理超时时间，是否复用请求客户端；例如在Next.js API路由中创建全局fetch客户端实例，复用连接池避免每次请求新建连接
• 示例代码（Next.js API路由复用连接）：

import { Agent } from 'https';
// 全局实例化keep-alive的Agent
const keepAliveAgent = new Agent({ keepAlive: true });

export async function GET(request) {
  const response = await fetch('http://your-php-api-address', {
    agent: keepAliveAgent
  });
  return response;
}

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