本文介绍如何使用 try_files 指令配合命名 location，让 nginx 优先服务真实存在的静态资源（如 css、js、图片），仅在路径无对应文件时才将请求重写至 php 路由入口，避免误重定向导致前端资源加载失败。
本文介绍如何使用 try_files 指令配合命名 location，让 nginx 优先服务真实存在的静态资源（如 css、js、图片），仅在路径无对应文件时才将请求重写至 php 路由入口，避免误重定向导致前端资源加载失败。
在构建基于 PHP 的单入口路由应用（如用户主页 http://localhost/username）时，一个常见需求是：静态资源应直接响应，而不存在的路径则交由 index.php 统一处理。若直接使用 rewrite 指令（如 rewrite ^/(.+)$ /index.php?... last;），Nginx 会无差别匹配所有请求——包括 /style.css、/app.js 等，导致静态资源被错误重写，最终返回 PHP 脚本内容或 404，严重破坏页面渲染。
正确做法是利用 Nginx 内置的 try_files 指令进行存在性判断，并结合命名 location 实现逻辑分支。其核心思想是：
✅ 先尝试匹配 $uri（精确路径，如 /main.css）
✅ 再尝试 $uri/（目录索引，如 /assets/）
❌ 若均不匹配，则跳转至预定义的 @rewrite 命名 location 执行重写
以下是推荐配置：
location / {
# 依次检查：当前 URI 是否为真实文件 → 是否为真实目录 → 否则跳转至 @rewrite
try_files $uri $uri/ @rewrite;
}
# 命名 location，仅在 try_files 失败时触发
location @rewrite {
# 将路径中用户名部分提取为 username 参数，转发至 index.php
rewrite ^/(.+)$ /index.php?type=userinfo&username=$1 last;
}⚠️ 关键注意事项：
- try_files 必须放在 location / {} 块内，且不能与 rewrite 混用在同一层级（否则可能绕过判断）；
- @rewrite 是命名 location，以 @ 开头，不可被外部 URL 访问，仅用于内部跳转；
- last 标志表示重写后重新匹配 location，确保后续可能的 PHP 处理（如 location ~ \.php$）能正常生效；
- 若需排除特定扩展名（如 .php 自身），可额外添加 =404 或前置更具体的 location 规则，但通常 try_files 已足够健壮。
此方案兼顾性能与语义清晰性：Nginx 在内核层完成文件存在性检查，无需 PHP 参与，零额外开销；同时完全隔离静态资源与动态路由，是现代 PHP 应用（如 Laravel、Symfony 的 Nginx 部署）的标准实践。
