Symfony 5文件下载遇404错误：请求资源未找到求助

针对你遇到的通过URL下载文件返回404的问题，从路由、服务器配置、参数规则几个方向排查修复：

1. 确认路由是否正确加载并匹配 #

首先验证路由是否被Symfony正确识别：

• 执行终端命令查看路由详情：

  php bin/console debug:router download_excel
  

  如果输出中没有该路由，或者路径与你访问的URL不匹配，先清理缓存：

  php bin/console cache:clear
  

  （开发环境无需加--env=prod，生产环境需要）

2. 调整路由参数匹配规则 #

Symfony路由参数默认的匹配规则是[^/]+，虽然你的文件名不含特殊字符，但如果文件名包含点号以外的特殊字符（或后续可能出现），会导致路由不匹配。修改routes.yaml，添加参数匹配规则：

download_excel:
  path:       /api/order/download_excel/{filename}
  controller: App\Controller\OrderController::downloadExcelAction
  methods:    GET
  requirements:
    filename: '.+'  # 允许文件名包含除斜杠外的任意字符

3. 检查服务器配置（关键） #

如果路由配置正确但仍返回404，大概率是服务器（Nginx/Apache）没有将请求转发给Symfony的入口文件：

• Nginx：确保你的配置中，/api前缀的请求被转发到public/index.php，示例配置片段：

  location /api {
      try_files $uri $uri/ /index.php$is_args$args;
  }
  

  避免服务器将/api/order/download_excel/xxx.xlsx当作静态文件去查找，导致直接返回404。
• Apache：检查项目根目录的.htaccess文件是否正确，默认Symfony的.htaccess会将所有非静态文件请求转发到index.php，如果自定义了规则，确保/api路径的请求不会被拦截。

4. 验证请求URL的正确性 #

• 确认访问的URL包含项目的完整路径，比如项目部署在http://localhost/CustomerApi，则完整下载URL应为：

  http://localhost/CustomerApi/api/order/download_excel/order_export_20230520084729.xlsx
  

• 检查文件名是否完全匹配，注意大小写（Linux环境下文件名区分大小写）。

5. 优化控制器代码（避免realpath干扰） #

虽然当前404不是控制器逻辑问题，但可以优化文件路径判断，避免realpath可能带来的异常：

public function downloadExcelAction(string $filename): BinaryFileResponse
{
    $projectDir = $this->getParameter('kernel.project_dir');
    $filePath = $projectDir . '/public/excel/' . $filename;

    // 先判断路径是否为安全路径（防止目录遍历攻击）
    $excelDir = realpath($projectDir . '/public/excel');
    if (strpos(realpath($filePath), $excelDir) !== 0) {
        throw new \Exception('Không được truy cập file ngoài thư mục.', 403);
    }

    if (!file_exists($filePath) || !is_file($filePath)) {
        throw new \Exception('File Excel không tồn tại.', 404); // 这里改为404更符合语义
    }

    $response = new BinaryFileResponse($filePath);
    $response->setContentDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, $filename);
    return $response;
}

添加目录遍历防护，同时将文件不存在的异常改为404，更符合HTTP状态码语义。

内容的提问来源于stack exchange，提问作者hellcat thành