本文介绍如何使用 try_files 指令配合命名 location，让 nginx 优先服务真实存在的静态资源（如 css、js、图片），仅在路径无对应文件时才将请求交由 php 路由处理，避免误重写导致前端资源加载失败。
本文介绍如何使用 try_files 指令配合命名 location，让 nginx 优先服务真实存在的静态资源（如 css、js、图片），仅在路径无对应文件时才将请求交由 php 路由处理，避免误重写导致前端资源加载失败。
在构建基于 URL 路径的用户系统（如 https://www.php.cn/link/5ff3fd94bc09fae5dab3de636b8f130c）时，常见的误区是直接使用全局 rewrite 规则——这会导致所有请求（包括 /style.css、/app.js）都被无差别重写到 index.php，造成静态资源无法加载、页面样式丢失、脚本报错等严重问题。
正确的做法是利用 Nginx 的 条件式路径匹配机制：先尝试定位真实文件或目录，仅当全部失败时，再触发动态路由回退。核心指令是 try_files，它按顺序检查每个指定路径是否存在，支持变量、状态码跳转和命名 location 跳转。
✅ 推荐配置如下：
location / {
# 依次检查：1. 完全匹配的文件；2. 同名目录（带/）；3. 转发至 @rewrite 命名 location
try_files $uri $uri/ @rewrite;
}
# 命名 location 不参与常规匹配，仅被内部跳转调用
location @rewrite {
# 将 /username 形式路径解析为 query 参数，安全传递给 index.php
rewrite ^/(.+)$ /index.php?type=userinfo&username=$1 last;
}? 关键说明：
- $uri 表示解码后的原始 URI（不含参数），如请求 /main.css 时，Nginx 会查找磁盘上 root 目录下的 main.css 文件；
- $uri/ 用于匹配目录索引（如访问 /blog/ 时尝试 index.html）；
- @rewrite 是命名 location，不接受外部直接访问，仅作为 try_files 的兜底出口，确保重写逻辑隔离、可控；
- last 标志表示重写后重新匹配 location，确保后续可能的 PHP 处理（如 location ~ .php$）能正常生效。
⚠️ 注意事项：
- 确保 root 或 alias 指令已正确定义在 server 或 location 块中，否则 $uri 查找将失败；
- 避免在 try_files 中使用 =404 等终止动作替代命名 location，否则无法执行后续 rewrite；
- 若需排除特定后缀（如 .php）防止循环，可添加前置 location 块显式处理，但本方案中因 @rewrite 生成的是 /index.php?...，只要 PHP location 正确配置，不会引发二次重写；
- 开发阶段建议启用 error_log /path/to/error.log notice; 并观察日志，验证 try_files 的实际匹配路径。
该方案兼顾性能与灵活性：静态资源由 Nginx 零拷贝高效响应，动态请求才交由 PHP 解析，是现代 PHP 应用（如 Laravel、Symfony 的路由模式）在 Nginx 下的标准实践。
