本文详细阐述了在symfony应用与nginx配合部署时，如何解决静态文件（如pdf）下载或访问时出现“文件未找到”或“下载失败”的问题。核心在于通过nginx的location指令，为特定文件类型配置正确的静态文件服务规则和content-type响应头，确保nginx能够正确识别并提供这些文件，而非将其误导至php处理。
Symfony应用与Nginx静态文件服务配置详解
在使用Symfony等PHP框架构建Web应用并部署到Nginx服务器时，开发者常会遇到静态文件（如图片、CSS、JavaScript、PDF等）无法正常访问或下载的问题。尽管在开发环境（如使用Symfony内置的Web服务器）下一切正常，但在生产环境Nginx上，文件路径可能指向错误，导致浏览器显示“文件未找到”或下载失败。本文将深入探讨这一问题的原因，并提供详细的Nginx配置解决方案。
问题根源分析
Symfony应用通常采用“前端控制器”模式，所有请求（除了显式声明的静态文件）都会被路由到public/index.php进行处理。Nginx的配置需要正确地将静态文件请求与动态PHP请求区分开来。
在典型的Nginx配置中，通常会有一个通用location /块来处理所有请求，并使用try_files指令来尝试查找文件，如果找不到，则将请求重写到index.php。然而，如果try_files配置不当，或者没有为特定的静态文件类型（如PDF）添加明确的location块，Nginx就可能将这些静态文件请求也误导至index.php，导致PHP尝试处理一个实际上是静态文件的URL，最终返回404错误或下载失败。
以原始的Nginx配置为例：
server {
server_name xxx.xxx.com;
root /var/www/xxx.xxx.com/public;
index index.php;
location / {
# 这里的try_files /index.php /index.php; 过于激进，会把所有未明确处理的请求都导向index.php
try_files /index.php /index.php;
include snippets/fastcgi-notry-php.conf;
fastcgi_pass unix:/var/run/php/php-fpm.sock;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php-fpm.sock;
}
# 已有针对CSS和JS的静态文件处理
location ~ \.css {
add_header Content-Type text/css;
}
location ~ \.js {
add_header Content-Type application/x-javascript;
}
}可以看到，.css和.js文件有专门的location块来处理，确保它们作为静态文件被正确服务，并设置了正确的Content-Type。这正是解决问题的关键思路。对于PDF文件，由于缺少类似的显式配置，Nginx会将其请求匹配到location /，然后被try_files /index.php /index.php;重写到index.php，从而无法正确下载。
解决方案：Nginx静态文件类型配置
解决此问题的核心是为需要作为静态文件服务的特定文件类型（如PDF）添加一个独立的location块。这个location块应该在通用location /块之前被Nginx匹配，并指示Nginx直接服务这些文件，同时设置正确的Content-Type响应头。
示例代码：添加PDF文件处理
在您的Nginx server块中，添加以下配置：
location ~ \.pdf {
add_header Content-Type application/pdf;
}将此配置块放置在现有的.css和.js location块旁边，或者在location /块之前，以确保Nginx能够优先匹配并处理PDF文件。
完整的Nginx配置示例：
server {
server_name xxx.xxx.com;
root /var/www/xxx.xxx.com/public;
index index.php;
# 优先处理静态文件类型
location ~ \.pdf {
add_header Content-Type application/pdf;
# 可选：如果希望浏览器直接下载而不是预览，可以添加以下头
# add_header Content-Disposition "attachment; filename=$uri";
}
location ~ \.css {
add_header Content-Type text/css;
}
location ~ \.js {
add_header Content-Type application/x-javascript;
}
# 处理PHP文件请求
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php-fpm.sock;
}
# 处理所有其他请求，尝试作为文件或目录，否则重写到index.php
# 注意：这里我们修改了原始的try_files，以允许Nginx先查找静态文件
location / {
# 推荐的Symfony Nginx try_files配置，优先尝试查找文件和目录
try_files $uri $uri/ /index.php$is_args$args;
# 如果您的PHP FPM配置已在fastcgi-php.conf中处理，这里通常不需要重复fastcgi_pass
# 原始配置中的 include snippets/fastcgi-notry-php.conf; 和 fastcgi_pass
# 可能在新的try_files下不再需要，或需要根据实际snippets内容调整。
# 对于标准Symfony应用，所有动态请求最终都应由location ~ \.php$ 处理。
}
}配置说明：
- location ~ \.pdf: 这是一个正则表达式匹配，表示任何以.pdf结尾的请求都将由这个块处理。Nginx会优先匹配更具体的正则表达式location块。
- add_header Content-Type application/pdf;: 这是最关键的部分。它告诉浏览器该文件的MIME类型是application/pdf。浏览器会根据这个MIME类型来决定如何处理文件，例如是直接在浏览器中打开预览，还是弹出下载对话框。
- root /var/www/xxx.xxx.com/public;: root指令定义了Nginx查找文件的根目录。当请求/pdf/1.pdf时，Nginx会在/var/www/xxx.xxx.com/public/pdf/1.pdf路径下寻找文件。
- try_files $uri $uri/ /index.php$is_args$args;: 这是一个更标准的Symfony Nginx location /配置。它首先尝试查找与请求URI匹配的文件 ($uri)，如果找不到，则尝试查找与请求URI匹配的目录 ($uri/)，如果仍然找不到，则将请求重写到index.php，由Symfony框架处理。这确保了静态文件可以被Nginx直接服务，而动态路由则由Symfony处理。
推广到其他静态文件类型
如果您有其他需要作为静态文件服务的类型（例如.zip、.docx、.xlsx、图片文件等），可以采用相同的模式添加相应的location块，并设置正确的Content-Type。
例如，对于图片文件，可以添加更优化的缓存配置：
location ~* \.(jpg|jpeg|png|gif|ico|svg)$ {
expires 30d; # 设置缓存过期时间为30天
log_not_found off; # 不记录404错误日志，因为很多图标文件可能不存在
add_header Cache-Control "public, no-transform"; # 优化浏览器缓存策略
# 如果文件不存在，Nginx会直接返回404，不会尝试重写到index.php
try_files $ 
