本文详解如何在 nginx 配置中安全、可靠地为 `/admin/users.php` 这一特定 uri 自动添加固定查询参数（如 `?sort_by=id&dir=asc&lim=2&flt=1`），避免重写冲突、无限循环及参数丢失问题，并提供生产环境可用的配置方案。
在 Nginx 中为特定 PHP 资源追加查询参数看似简单，但极易因 location 匹配优先级、rewrite 执行顺序或 flag 语义误用而导致失败——例如参数未生效、请求被错误截断，甚至触发 500 内部重定向循环。根本原因在于：Nginx 的正则 location（如 ~ \.php$）优先级高于前缀 location（如 location /admin/users.php），且 rewrite 指令在同一个 location 块中按序执行、受 break/last 控制流程。
因此，将 rewrite 规则置于独立的前缀 location 块中（如 location /admin/users.php { ... }）不仅无效，还可能因与后续 PHP 处理块冲突而被跳过。正确做法是：将 rewrite 直接嵌入负责 PHP 解析的正则 location 块内，并严格保证规则顺序与语义一致性。
以下为推荐配置（适配您当前 default.conf 结构）：
location ~ \.php$ {
# ✅ 优先匹配并重写 /admin/users.php → 添加参数后转发至 /users.php（保持路径简洁）
rewrite ^/admin/users\.php$ /users.php?sort_by=id&dir=ASC&lim=2&flt=1 break;
# ✅ 通用规则：剥离 /admin/ 前缀（如 /admin/app.php → /app.php），放在此后确保不干扰上一条精确匹配
rewrite ^/admin/?(.*)$ /$1 break;
# ⚠️ 关键：必须在 rewrite 后加载 FastCGI 参数，否则 QUERY_STRING 可能未正确传递
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTP_PROXY "";
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
}? 关键说明：rewrite ^/admin/users\.php$ ... break; 使用 ^...$ 确保精确匹配，防止误触 /admin/users.php.bak 等路径；末尾的 \. 转义点号避免正则歧义；两条 rewrite 共存时，顺序即逻辑：第一条专用于 /admin/users.php 并立即 break（终止当前 location 内后续 rewrite），第二条处理其他 /admin/xxx 请求；break 表示重写后继续执行同一 location 内后续指令（如 include fastcgi_params），而 last 会重新匹配 location，易引发循环——此处必须用 break；include fastcgi_params; 必须放在所有 rewrite 之后，确保 $query_string（含新追加参数）已就绪并被 fastcgi_param QUERY_STRING $query_string; 正确传递给 PHP。
? 验证建议：
重启 Nginx 后，访问 http://your-domain:4000/admin/users.php，使用 curl -I 或浏览器开发者工具检查响应头中的 Location（若存在重定向）或直接查看 PHP 中 $_SERVER['QUERY_STRING'] 的值，确认输出为 sort_by=id&dir=ASC&lim=2&flt=1。
? 总结：Nginx URI 重写不是“拼凑规则”，而是理解其匹配机制与执行模型后的精准编排。针对特定 PHP 路径追加参数，务必在最高优先级的 PHP 处理 location 中定义精确 rewrite，并严守顺序、flag 与参数加载时机——这既是最佳实践，也是避免线上故障的核心保障。
立即学习“PHP免费学习笔记（深入）”；
