Laravel框架采用的是单一入口的前端控制器模式，所有HTTP请求最终都要交给public目录下的index.php处理，再由框架内部的路由组件分发到对应的控制器。这种设计带来了灵活的路由能力，但也意味着传统服务器不能直接按物理文件路径去解析URL。如果直接把Laravel项目扔到Nginx上不做任何配置，通常会出现首页能打开、其他所有路由全部404的情况，这就是所谓优雅路由失效问题。
为什么Laravel需要特殊处理路由
Laravel的路由定义在routes目录下，比如你定义了一个Route::get('/user/profile', ...)，用户访问的URL路径是/user/profile，但服务器上根本不存在user/profile这个文件或目录。Nginx默认的行为是：先找文件，找不到就找目录，再找不到就返回404。它不知道这些请求都应该转交给index.php去处理。
要解决这个问题，就要用到Nginx的try_files指令。这条指令的含义是：依次尝试查找给定的文件或目录，如果全部不存在，就回退到最后一个参数指定的内部重定向。对Laravel来说，标准的写法是try_files $uri $uri/ /index.php?$query_string，翻译成人话就是：先看请求的是不是真实文件，再看看是不是真实目录，都不是的话，把请求连同查询字符串一起交给index.php。
这里有个非常容易踩的坑：末尾的?$query_string千万不能省。如果写成/index.php，所有GET参数都会丢失，分页、搜索、过滤功能会集体失灵，而且这种问题往往不容易在测试环境第一时间发现，等上线后用户反馈搜索不了才恍然大悟。
完整的Nginx配置示例
下面给出一份可直接用于生产的配置，包含站点根目录指向、路由回退、PHP处理和安全相关设置三个核心部分。
server {
listen 80;
server_name example.ipipp.com;
root /var/www/laravel-app/public; # 必须指向public目录
index index.php index.html;
charset utf-8;
location / {
# 核心规则：找不到真实文件就交给index.php
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# 禁止访问隐藏文件，比如.env配置文件
location ~ /\.(?!well-known).* {
deny all;
}
# 静态资源缓存
location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|woff2?)$ {
expires 30d;
access_log off;
}
}配置中有几个细节值得注意。第一，root必须指向public子目录而不是项目根目录，如果指错了位置，.env文件、composer.json、storage目录全都暴露在公网上，等于把家门钥匙挂在门把手上。第二，PHP的location块里加try_files $uri =404是为了防止路径注入攻击，避免恶意用户构造不存在的PHP路径让FPM执行意外代码。第三，PHP-FPM的socket路径要和服务器实际安装的版本对应，查看/etc/php/8.2/fpm/pool.d/www.conf里的listen配置可以确认。
修改完配置别忘了测试和重载：nginx -t检查语法，nginx -s reload平滑重载。如果还是404，优先检查Laravel项目根目录下的.env中APP_URL是否正确，以及storage和bootstrap/cache目录是否有写权限：chown -R www-data:www-data storage bootstrap/cache。
优雅路由与伪静态进阶优化
开启优雅路由后，URL中不再需要index.php这个丑陋的前缀，对SEO和用户体验都更友好。如果希望URL以.html之类的后缀结尾，可以在路由定义中直接写Route::get('/article/{id}.html', ...)，Nginx会因为找不到该文件而自动回退到index.php，伪静态效果就实现了。
对于前后端分离项目，还有一种常见需求是Laravel只作为API后端，所有API路由统一挂在/api前缀下。这时可以针对该前缀单独设置location，关闭不必要的日志记录，并添加CORS相关的响应头，示例如下。
location /api {
try_files $uri $uri/ /index.php?$query_string;
access_log off;
add_header Access-Control-Allow-Origin $http_origin always;
add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
}
# 处理OPTIONS预检请求，直接返回204
location ~ ^/api/ {
if ($request_method = OPTIONS) {
return 204;
}
try_files $uri /index.php?$query_string;
}再补充两个实用技巧：一是在listen指令后加http2开启HTTP/2，配合gzip压缩CSS、JS和JSON响应，能明显提升接口响应速度；二是给Vite构建的带哈希文件名的资源设置更长的过期时间，比如expires 365d，因为文件内容一变哈希就变，缓存自动失效，完全不用担心更新问题。把这些配置组合起来，一个既能优雅路由、又兼顾性能与安全的Laravel线上环境就搭建完成了。
Laravel路由Nginx伪静态try_files配置修改时间：2026-09-16 07:28:41