如何在Nginx中通过404页面请求并正常返回媒体内容？

我之前碰到过几乎一模一样的坑！你猜的没错，核心问题确实是Nginx已经提前发送了404状态码——哪怕你的PHP脚本输出了正确的媒体内容，浏览器看到开头的404状态头就会拒绝正常渲染内容，必须刷新让Nginx直接返回本地文件才行。另外你的PHP代码还有几个致命小错误，一起给你修正：

一、先搞定Nginx的状态码问题 #

默认情况下，Nginx的error_page 404 /404.php;会把404状态码传递给后端PHP，哪怕你在PHP里设置了200头，浏览器还是会先收到Nginx发送的404。所以要修改Nginx配置，强制重置状态码：

server {
    # 其他原有配置...
    error_page 404 =200 /404.php; # 关键：用=200重置状态码为200
    location /image/ {
        try_files $uri $uri/ /404.php; # 先尝试本地文件，不存在则走404.php
    }
    location ~ \.php$ {
        # 你的PHP-FPM配置示例，根据实际环境调整
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

二、修正PHP代码的致命错误 #

你的伪代码里有两个关键错误：

1. file_put_contents的参数顺序完全写反了！应该是本地文件路径在前，远程文件内容在后
2. 没有先重置HTTP状态码，即使Nginx配置对了，PHP也要确保发送200头

另外还要加一些容错处理，避免下载失败时输出空内容，同时支持自动识别MIME类型（不用硬编码video/mp4）：

<?php
// 先重置HTTP状态码为200，必须在任何输出之前（包括空格、BOM）
http_response_code(200);

// 整理请求路径，确保本地文件路径正确
$requestUri = trim($_SERVER['REQUEST_URI'], '/');
$localFile = $_SERVER['DOCUMENT_ROOT'] . '/' . $requestUri;
$remoteFile = 'https://s3.example.com/' . $requestUri; // 必须加协议头

// 双重保险：检查本地文件是否存在（Nginx的try_files已经做了，但防止意外）
if (!file_exists($localFile)) {
    // 从S3下载文件内容
    $remoteContent = file_get_contents($remoteFile);
    if ($remoteContent === false) {
        // 下载失败，返回真实404
        http_response_code(404);
        echo 'File not found on S3';
        exit;
    }
    // 确保目标目录存在（比如image下的子目录）
    $dir = dirname($localFile);
    if (!is_dir($dir)) {
        mkdir($dir, 0755, true);
    }
    // 写入本地文件
    file_put_contents($localFile, $remoteContent);
}

// 自动识别MIME类型，适配图片/视频等多种格式
$finfo = new Finfo(FILEINFO_MIME_TYPE);
$mimeType = $finfo->file($localFile);
header("Content-Type: $mimeType");

// 处理大文件分段请求（支持视频拖拽）
$fileSize = filesize($localFile);
if (isset($_SERVER['HTTP_RANGE'])) {
    preg_match('/bytes=(\d+)-(\d+)?/', $_SERVER['HTTP_RANGE'], $matches);
    $start = intval($matches[1]);
    $end = isset($matches[2]) ? intval($matches[2]) : $fileSize - 1;
    $length = $end - $start + 1;
    header("HTTP/1.1 206 Partial Content");
    header("Content-Range: bytes $start-$end/$fileSize");
    header("Content-Length: $length");
    $file = fopen($localFile, 'r');
    fseek($file, $start);
    echo fread($file, $length);
    fclose($file);
} else {
    // 正常返回完整文件
    header("Accept-Ranges: bytes");
    header("Content-Length: $fileSize");
    readfile($localFile);
}
exit;
?>

三、额外优化建议 #

• 给PHP的file_get_contents加超时设置，避免S3响应慢导致请求挂起：可以用stream_context_create设置超时参数
• 对S3的请求建议用AWS官方SDK代替file_get_contents，更稳定（支持签名、重试、断点续传）
• 给Nginx添加缓存头，减少重复请求对服务器的压力
• 限制404.php仅处理/image/路径下的请求，避免被恶意滥用

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