PHP项目如何排查站点重定向错误？

关键发现： 如果看到 A 请求返回 302 指向 B，B 请求又返回 302 指向 A，这就是典型的重定向循环。

第二步：排查常见的 PHP 项目重定向源头

PHP 代码逻辑（最常见）

在 PHP 文件中搜索以下函数或模式：

• header('Location: ...')：手动定义的重定向。
• header("HTTP/1.1 301 Moved Permanently") + header(...)：自定义的状态码。
• wp_redirect()、wp_safe_redirect() （WordPress 项目）。
• Redirect::to() （Laravel 框架）。
• $this->redirect() （CI、Yii 等框架）。

排查技巧：

• 使用 IDE 搜索整个项目：搜索 header + Location。
• 检查控制器/路由中间件：Laravel 的 CheckAuth 中间件，如果用户未登录，可能重定向到登录页；如果登录页又在检查到用户已登录时重定向回首页，可能形成循环。
• 检查 __construct 和 init 钩子：WordPress 中很多重定向逻辑放在 template_redirect 钩子里。

Web 服务器配置（Nginx / Apache）

• Nginx：
  • 检查 nginx.conf 或站点配置文件（/etc/nginx/sites-available/）。
  • 搜索 return 301、return 302、rewrite 指令。
  • 常见错误：强制 HTTPS 规则配置不当（例如把所有 HTTP 请求重定向到 HTTPS，但 HTTPS 站点本身又没正确处理，导致请求不断在 HTTP 和 HTTPS 之间跳转，或 HTTPS 本身又在重定向 HTTP）。
• Apache：
  • 检查 .htaccess 文件（站点根目录、子目录都可能存在）。
  • 搜索 RewriteRule、RewriteCond、Redirect 指令。
  • 常见错误：多个 .htaccess 文件叠加规则，或者 RewriteRule 的 [L]（Last）标志缺失，导致一个请求命中多个重写规则。

框架或 CMS 的特殊缓存/配置

• WordPress：
  • 检查 wp-config.php 中 WP_HOME 和 WP_SITEURL 是否一致（常见于迁移域名后）。
  • 数据库 wp_options 表中的 siteurl 和 home 字段。
  • 插件冲突（安全插件如 Wordfence、缓存插件、SEO 插件如 Yoast 的重定向功能）。
  • wp-blog-header.php 中的逻辑。
• Laravel / Symfony：
  • 检查 config/session.php 中的 domain 和 secure 设置。
  • 检查路由文件（web.php、api.php）中是否有隐式重定向（如 Redirect::route('login')）。

负载均衡器或 CDN 配置

• 如果使用了 Nginx 反向代理、AWS ELB、CloudFlare 等，它们也可能在应用层之前进行重定向。
• CloudFlare 的 SSL/TLS 设置（Flexible/Full/Strict）配置错误，可能导致 HTTP<->HTTPS 循环。

第三步：使用命令行和日志工具进行深度排查

查看服务器访问日志（最重要）

日志会记录每一次请求和状态码,是解决重定向问题的“黑匣子”。

• Nginx: tail -f /var/log/nginx/access.log
• Apache: tail -f /var/log/apache2/access.log
• PHP 错误日志: tail -f /var/log/php_errors.log （PHP 代码逻辑错误可能导致重定向中断或异常）

日志分析示例：

- - [10/Apr/2025:10:00:01 +0800] "GET /login HTTP/1.1" 302 5 "-" "Mozilla/..."
- - [10/Apr/2025:10:00:01 +0800] "GET /dashboard HTTP/1.1" 302 5 "-" "Mozilla/..."
- - [10/Apr/2025:10:00:01 +0800] "GET /login HTTP/1.1" 302 5 "-" "Mozilla/..."

如果看到 /login 和 /dashboard 交替出现，就找到了循环链。

使用 curl 模拟请求（不跟浏览器跳转）

curl -v -L --max-redirs 0 http://example.com

• -v：显示详细请求头。
• -L：跟随重定向（可选，如果不加 -L，curl 会停在第一个 302）。
• --max-redirs 0：限制重定向次数为 0（实际是用来测试不跟随时的状态）。

更实用的命令：

curl -v http://example.com 2>&1 | grep -i "Location\|HTTP/"

这会显示出来自服务器的所有 Location 头，让你看到重定向链条的每一步。

使用 Xdebug 调试（针对 PHP 代码）

如果代码复杂,可以本地或远程启用 Xdebug：

1. 在 index.php 或框架入口加一个断点。
2. 逐行执行,观察当 header() 函数被调用时，Location 的值是什么。
3. 检查是哪个条件触发了这个重定向（if (!isset($_SESSION['user']))）。

第四步：针对特定场景的解决方案

最佳排查路径（按优先级）

1. 看浏览器 Network 标签：直接看到循环链或错误的 Location。
2. 查服务器 access.log：看实际请求路径的 301/302 模式。
3. 用 curl 命令：在服务器终端直接测试，排除浏览器缓存干扰。
4. 检查 Web Server 配置：Nginx/Apache/.htaccess（尤其是强制 SSL 规则）。
5. 检查 PHP 代码：搜索 header('Location'，尤其是入口文件、控制器、中间件。
6. 检查 CMS/框架缓存：WordPress 的 options 表、Laravel 的路由缓存。
7. 检查外部设施：CDN、CloudFlare 的 SSL 模式、反向代理。

通过以上步骤,一般能快速定位并修复 PHP 项目中的重定向错误，如果问题依然存在，可以把抓包得到的完整请求链发出来，结合具体现象进一步分析。