rewrite指令必须写在匹配目标路径的location块内，如/image/应配location ^~ /image/；错误写入根location /会导致不匹配，且需确保重写后uri能被php location ~ .php$正确处理。
rewrite 指令写在了错误的 location 块里
Nginx 的 rewrite 只在匹配到对应 location 时才执行，如果规则写在 location /admin { ... } 里，但请求路径是 /uploads/123.jpg，那它根本不会被处理。很多从 Apache 迁移的人习惯把所有规则塞进根 location /，但实际更稳妥的是：用 try_files 处理前端控制器（如 Laravel、WordPress），只对明确需要重写的路径（如图片路由）单独写 location。
常见错误示例：
location / {
rewrite ^/image/(\d+)\.jpg$ /image.php?id=$1 last; # ❌ 错误：/image/xxx.jpg 不匹配 /，因为 /image/ 是子路径
}
正确做法是单独定义路径前缀：
location ^~ /image/ {
rewrite ^/image/(\d+)\.jpg$ /image.php?id=$1 last;
}
-
^~优先级高，避免被正则location ~ \.php$截断 - 确保
image.php能被 PHP-FPM 正确解析（检查location ~ \.php$是否覆盖该路径） - 用
last而非break，否则重写后不再重新匹配 location
rewrite 后没触发 PHP 解析，返回了源码或 404
rewrite 只改 URL，不自动转发给 PHP 处理器。如果重写目标是 /image.php?id=123，但 Nginx 没配置 PHP 处理逻辑，就会直接返回 image.php 的源码（未解析）或 404（找不到静态文件）。
必须保证两点：
- 重写后的 URI 必须落入能触发 PHP-FPM 的
location ~ \.php$或类似块中 - fastcgi_param 需要传递原始请求信息，尤其是
SCRIPT_FILENAME
典型修复配置片段：
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
# ⚠️ 注意：若 rewrite 后路径含 query string（如 ?id=123），需保留 $args 或 $query_string
fastcgi_param QUERY_STRING $query_string;
}
正则捕获变量在嵌套 rewrite 中丢失
Nginx 的 rewrite 每次执行都会重置 、 等捕获变量。如果你在一个 location 里写了多条 rewrite，第二条无法使用第一条的捕获结果。
例如这个写法无效：
rewrite ^/api/v1/(.*)$ /api.php?version=1&path=$1 break; rewrite ^/api/v2/(.*)$ /api.php?version=2&path=$1 break;
因为第二条 rewrite 不知道第一条的 $1 是什么。解决方法只有两个：
- 拆成独立的
location块（推荐） - 用
if+set提前保存，但if在location中有诸多限制，慎用
更安全的替代方案是用 try_files + QUERY_STRING 透传，避免多层 rewrite。
没禁用 autoindex 导致目录列表暴露，掩盖了 rewrite 问题
当 rewrite 规则本应把 /uploads/ 映射到 image.php，但实际看到的是目录列表，说明请求根本没进 rewrite 流程——大概率是 Nginx 找不到匹配的 location，回落到了默认行为：显示目录索引。
立刻检查并确认以下两行存在于 server 块中：
autoindex off; index index.php index.html;
尤其注意：autoindex on 可能藏在某个 include 文件里（比如 aapanel 自动生成的配置），全局搜一遍比凭印象靠谱。一旦开启，Nginx 会优先列出文件，rewrite 规则形同虚设。
最常被忽略的点：rewrite 规则生效依赖于整个请求生命周期中 location 匹配、变量传递、PHP 转发三者协同；任一环节断开，表现都是“伪静态不生效”，但原因可能天差地别——有人卡在正则没匹配，有人卡在 SCRIPT_FILENAME 拼错路径，还有人只是忘了删掉 autoindex。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
