Laravel空API文件传输耗时过长，如何优化Apache/Nginx配置？

核心问题定位 #

空请求响应快说明Laravel应用逻辑无瓶颈，问题集中在服务器请求接收缓存策略、传输协议配置、PHP-FPM资源调度，或是大文件上传时的磁盘/网络IO瓶颈。

一、Nginx/Apache 传输层优化 #

1. 内存缓存请求体，避免磁盘写入 #

大文件上传时，服务器默认会把请求体写入临时磁盘文件，这会大幅增加耗时，优先配置内存缓存：

• Nginx：

  http {
      client_max_body_size 10M; # 设置为大于你上传的文件大小
      client_body_buffer_size 8M; # 大于文件大小则直接缓存到内存，跳过磁盘写入
      client_body_temp_path /tmp/client_body 1 2; # 必须写磁盘时，指定高速磁盘路径（如tmpfs挂载的目录）
      client_body_in_file_only off; # 强制关闭磁盘写入（默认就是off，确保没被修改）
  }
  

• Apache：
  切换到mpm_event模式（替代低效的prefork），并调整请求体限制与缓存：

  LimitRequestBody 10485760 # 10MB，匹配文件大小
  RequestReadTimeout header=30,MinRate=1000 body=60,MinRate=1000 # 避免请求超时，同时保证最低传输速率
  

2. 关闭冗余请求检查 #

• 临时关闭Nginx/Apache的安全模块（如mod_security、Nginx的modsecurity）测试，这类模块会对大请求体做扫描，显著增加耗时。
• 禁用不必要的日志（如access_log的详细记录），减少磁盘IO开销。

3. 修复HTTP/2配置（解决启用后耗时增加的问题） #

HTTP/2并非在所有场景下都更优，若配置不当反而会降低性能：

• Nginx：

  server {
      listen 443 ssl http2;
      ssl_protocols TLSv1.2 TLSv1.3; # 启用高效TLS版本
      ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
      http2_max_field_size 4k;
      http2_idle_timeout 60s; # 合理设置空闲超时，避免频繁重建连接
  }
  

  若HTTP/2仍慢，暂时切换回HTTP/1.1测试——部分网络环境（如低带宽、高丢包）下HTTP/1.1的表现更稳定。
• Apache：
  确保启用mpm_event，再配置HTTP/2：

  Protocols h2 http/1.1
  H2Push off; # 若不需要服务器推送，关闭以减少资源占用
  

二、PHP-FPM 资源调度优化 #

启用PHP-FPM后耗时增加，大概率是进程数配置不合理导致请求排队：

1. 调整php-fpm.conf核心参数：

   pm = dynamic
   pm.max_children = 10 # 按CPU核心数设置，4核服务器建议8-12
   pm.start_servers = 3 # 初始启动进程数，设为max_children的1/3左右
   pm.min_spare_servers = 2 # 最小空闲进程数
   pm.max_spare_servers = 6 # 最大空闲进程数
   request_terminate_timeout = 60 # 避免进程被过早终止
   

2. 同步PHP.ini配置：

   upload_max_filesize = 10M
   post_max_size = 12M # 略大于upload_max_filesize
   max_execution_time = 60
   

3. 启用FPM状态监控，排查排队情况：
   在php-fpm.conf中添加pm.status_path = /fpm-status，通过访问该路径查看是否有queue值过高的情况。

三、Laravel 应用层面优化 #

1. 流式处理上传文件：避免一次性把文件加载到内存，用流式读取减少内存占用与处理时间：

   public function upload(Request $request)
   {
       $file = $request->file('file');
       $stream = $file->getStream();
       // 流式写入到存储（如S3、本地磁盘）
       Storage::put('uploads/' . $file->getClientOriginalName(), $stream);
       return response()->json(['status' => 'success']);
   }
   

2. 跳过冗余中间件：针对上传API，跳过不需要的中间件（如CSRF验证）：

   Route::middleware(['api'])->withoutMiddleware([\App\Http\Middleware\VerifyCsrfToken::class])->group(function () {
       Route::post('/upload', [UploadController::class, 'upload']);
   });
   

3. 异步处理后续逻辑：如果上传后需要压缩、转码等操作，放到Laravel队列中后台执行，立即返回响应：

   public function upload(Request $request)
   {
       $file = $request->file('file');
       $path = $file->store('uploads');
       // 队列处理文件
       ProcessFileJob::dispatch($path);
       return response()->json(['status' => 'uploaded']);
   }
   

四、系统层面优化 #

1. 优化TCP传输参数：关闭TCP慢启动，减少传输启动延迟：

   echo "net.ipv4.tcp_slow_start_after_idle = 0" >> /etc/sysctl.conf
   sysctl -p
   

2. 检查磁盘IO：用iostat -x 1查看磁盘使用率，如果%util接近100%，说明磁盘IO瓶颈，可改用SSD或tmpfs挂载临时目录。
3. 测试服务器带宽：用speedtest-cli测试服务器上传带宽，若带宽不足（如低于1Mbps），5MB文件理论传输时间就会超过40s，需升级带宽。

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