本文介绍如何使用 try_files 指令配合命名 location，让 nginx 仅在请求路径不匹配任何真实静态文件（如 js/css/图片）时，才将请求交由 php 路由处理，避免误重写资源文件。
本文介绍如何使用 try_files 指令配合命名 location，让 nginx 仅在请求路径不匹配任何真实静态文件（如 js/css/图片）时，才将请求交由 php 路由处理，避免误重写资源文件。
在构建单入口 PHP 应用（如用户个人页 http://localhost/username）时，一个常见需求是：优先服务真实存在的静态资源（如 /style.css、/app.js），仅当路径对应文件不存在时，才将请求交由 index.php 统一处理。若直接使用 rewrite 指令（如 rewrite ^/(.+)$ /index.php?... last;），会导致所有请求（包括对 CSS/JS 的请求）无差别重写，造成资源加载失败。
正确做法是利用 Nginx 内置的 try_files 指令进行存在性判断，并结合命名 location 实现条件跳转。以下是推荐配置：
location / {
# 依次检查：1. 完全匹配的文件；2. 目录（带尾部斜杠）；3. 不存在则跳转到 @rewrite
try_files $uri $uri/ @rewrite;
}
# 命名 location，仅在 try_files 判定“文件不存在”时触发
location @rewrite {
rewrite ^/(.+)$ /index.php?type=userinfo&username=$1 last;
}✅ 工作流程说明：
- 用户请求 /main.css → try_files 找到磁盘上真实的 main.css 文件 → 直接返回，不进入 @rewrite；
- 用户请求 /alice → 无对应文件或目录 → 触发 @rewrite → 重写为 /index.php?type=userinfo&username=alice；
- 用户请求 /admin/（存在该目录）→ $uri/ 匹配成功 → 返回目录索引或 403/404，不重写。
⚠️ 关键注意事项：
- try_files 中的 $uri 是解码后的原始 URI（已处理 URL 编码），无需额外 decode；
- @rewrite 是内部跳转，不会改变浏览器地址栏，且不触发 HTTP 重定向（状态码仍为 200）；
- 若需支持根路径 / 访问（如首页），建议在 try_files 中补充 =404 或添加 index index.php; 配合默认首页逻辑；
- 确保 index.php 所在目录已通过 root 或 alias 正确定义，且 PHP-FPM 已正确配置 fastcgi_pass。
此方案兼顾性能与语义清晰性：静态资源零代理开销，动态路由精准可控，是现代 PHP 应用（Laravel、Symfony、自研框架等）在 Nginx 下的标准实践。
