API返回大文件时200状态码但响应为空的问题排查

以下是针对该问题的排查和解决方案：

1. 调整PHP执行超时参数 #

大文件处理耗时远超默认超时时间，会导致进程中断但返回200空响应。修改php.ini：

max_execution_time = 300  ; 根据文件大小调整，比如设为300秒
max_input_time = 300

重启PHP-FPM：

sudo service php8.3-fpm restart

2. 改用分段输出方式，禁用输出缓冲 #

直接读取大文件到内存再输出容易触发缓冲截断，采用分段读取并实时输出：

<?php
// 关闭所有输出缓冲
ob_end_clean();
// 设置正确的响应头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="your_large_file.ext"');
header('Content-Length: ' . filesize('/path/to/your/large_file.ext'));

// 1MB分段读取输出
$chunk_size = 1024 * 1024;
$file_handle = fopen('/path/to/your/large_file.ext', 'rb');

while (!feof($file_handle)) {
    echo fread($file_handle, $chunk_size);
    flush();
    ob_flush();
}

fclose($file_handle);
exit;
?>

3. 调整Nginx缓冲配置 #

Nginx的默认缓冲机制会对大文件处理造成影响，在server或location块中添加：

proxy_buffering off;
proxy_max_temp_file_size 0;
sendfile on;
tcp_nopush on;

如果是通过fastcgi连接PHP-FPM，在location ~ \.php$块中额外添加：

fastcgi_buffering off;
fastcgi_max_temp_file_size 0;

重启Nginx：

sudo systemctl restart nginx

4. 确认PHP为64位版本 #

32位PHP无法处理2GB以上文件，执行命令检查：

php -r "echo PHP_INT_MAX;"

若输出为2147483647，说明是32位版本，需更换为64位PHP。

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