本文详解如何使用 try_files 指令配合命名 location，让 nginx 优先服务静态资源（如 js/css/图片），仅在路径无对应文件时才将请求转发至 php 路由入口（如 index.php?username=xxx），避免误重写导致静态资源加载失败。
本文详解如何使用 try_files 指令配合命名 location，让 nginx 优先服务静态资源（如 js/css/图片），仅在路径无对应文件时才将请求转发至 php 路由入口（如 index.php?username=xxx），避免误重写导致静态资源加载失败。
在构建基于 PHP 的单入口动态路由应用（例如用户个人页 http://localhost/username）时，一个常见需求是：静态资源应直接响应，而未匹配的路径需交由后端统一处理。若错误地使用全局 rewrite（如 rewrite ^/(.+)$ /index.php?... last;），Nginx 会无差别重写所有请求——包括 /style.css、/app.js 等，导致前端资源 404，页面无法正常渲染。
正确做法是利用 Nginx 内置的 try_files 指令进行条件判断。它按顺序检查指定路径是否存在真实文件或目录，仅当全部检查失败时，才跳转至命名 location 执行后续逻辑。
✅ 推荐配置如下：
location / {
# 依次尝试：当前 URI 对应的文件 → 目录 → 命名 location @rewrite
try_files $uri $uri/ @rewrite;
}
# 命名 location（不暴露给外部，仅内部跳转使用）
location @rewrite {
rewrite ^/(.+)$ /index.php?type=userinfo&username=$1 last;
}? 关键说明：
- $uri 表示原始请求路径（如 /alice），Nginx 会先检查 ./alice 文件是否存在；
- $uri/ 表示将其视为目录（如 ./alice/），适用于子路径或索引页；
- @rewrite 是内部命名 location，不会触发外部重定向（HTTP 301/302），而是内部重发请求，性能更优；
- last 标志确保重写后重新匹配 location 块（例如进入 location ~ \.php$ 处理 PHP 请求）。
⚠️ 注意事项：
- 确保 index.php 文件实际存在于文档根目录，且已配置 PHP-FPM FastCGI 处理器；
- 若需支持根路径 / 访问首页，可在 try_files 中添加 =404 或显式处理（如 try_files $uri $uri/ /index.php?type=home last;）；
- 避免在 @rewrite 中使用 break —— 它会终止重写但不重新匹配 location，可能导致 PHP 脚本未被正确解析；
- 生产环境建议配合 location ~ \.php$ 块明确限定 PHP 处理范围，并启用 fastcgi_param SCRIPT_FILENAME 等安全参数。
通过该方案，http://localhost/alice 将正确路由至 index.php?type=userinfo&username=alice；而 http://localhost/style.css 会直接返回磁盘上的 CSS 文件，真正实现「静态优先、动态兜底」的健壮路由策略。
