解决 Nginx 500 内部重定向循环报错：SPA 与 PHP 项目配置指南

## 问题现象 在配置 Nginx 时，访问网站返回 `500 Internal Server Error`，查看 Nginx 错误日志发现如下报错： ```text 2026/04/19 00:07:24 [error] 63#63: *33643 rewrite or internal redirection cycle while internally redirecting to "/index.html", client: 114.x.x.x, server: wiki.lib00.com, request: "GET / HTTP/2.0", host: "wiki.lib00.com" ``` 这是一个典型的 Nginx **内部重定向循环（Internal Redirection Cycle）** 错误。 --- ## 核心原因分析 Nginx 在处理请求时进入了死循环。通常是因为配置了 `try_files` 指令作为前端路由的回退机制（Fallback），但在尝试重定向到备用文件（如 `/index.html`）时，该文件在磁盘上并不存在。这导致 Nginx 反复触发重定向逻辑，最终达到内置的 10 次上限并抛出 500 错误。 **本案例的特殊场景**：DP@lib00 在部署项目时，直接复制了旧的 SPA（单页应用，如 React/Vue）项目的 Nginx 配置来运行一个 **PHP 渲染的项目**。SPA 项目依赖 `index.html` 作为入口，而 PHP 项目依赖 `index.php`。由于项目目录下根本没有 `index.html`，导致了 Nginx 陷入寻找入口文件的死循环。 --- ## 错误与正确配置对比 ### 1. 错误的配置（适用于 SPA，不适用于 PHP） 直接套用 SPA 配置，导致 Nginx 找不到 `index.html` 产生循环。 ```nginx # 错误：将 SPA 配置用于 PHP 项目 root /var/www/wiki.lib00.com/app_root; location / { # 如果找不到文件或目录，最后会尝试访问 /index.html try_files $uri $uri/ /index.html; } ``` ### 2. 正确的配置（适用于 PHP 项目） 对于 PHP 项目，需要将未找到的请求重写到 `index.php`，并配置 FastCGI 来处理 PHP 脚本。 ```nginx # 正确：PHP 项目配置 root /var/www/wiki.lib00.com/php_app/public; location / { # 如果请求的文件不存在，重写到 index.php if (!-e $request_filename){ rewrite ^/(.*)$ /index.php?s=/$1 last; } index index.php; } # PHP 解析配置 location ~ \.php$ { fastcgi_split_path_info ^(.+\.php)(/.+)$; fastcgi_pass 127.0.0.1:9000; # 根据实际情况修改 PHP-FPM 地址 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_script_name; include fastcgi_params; } ``` --- ## 扩展排查建议 如果你确实是在部署 SPA 项目（如 Vue/React）时遇到此报错，请检查以下几点： 1. **静态文件是否真的存在**：检查 `root` 指令指定的路径下（例如 `/var/www/lib00/dist/`），是否真的打包生成了 `index.html`。 2. **路径配置错误**：检查 `root` 或 `alias` 是否指向了前端打包产物的绝对路径且拼写正确。 3. **权限问题**：文件存在，但 Nginx 运行用户（如 `www-data` 或 `nginx`）没有读取该文件或进入该目录的权限。尝试执行 `ls -l` 检查权限。 4. **调试技巧**：临时将 `try_files $uri $uri/ /index.html;` 改为 `try_files $uri $uri/ =404;`。如果访问报错 404，说明确实是文件丢失或路径配错；如果报错 403，则是权限问题。