rewrite or internal redirection cycle while internally redirecting to "/index.html", client: 45.148.10.235, server: localhost, request: "GET / HTTP/1.1",

### Nginx重写或内部重定向循环问题解决方案 Nginx 中出现 `rewrite or internal redirection cycle while internally redirecting to "/index.html"` 的错误通常是因为配置中的某些指令导致了无限循环的重定向逻辑。以下是可能的原因以及对应的解决方法： #### 可能原因分析 1. **`try_files` 指令引发的循环** 当使用 `try_files $uri $uri/ /index.html;` 时，如果 `/index.html` 文件不存在或者无法被正确匹配，则会触发再次尝试访问 `/index.html`，从而形成循环[^1]。 2. **多个监听冲突** 如果在同一台服务器上存在多个监听相同端口（如 80 端口）的配置文件，并且这些配置之间相互干扰，则可能导致请求处理异常并进入循环状态[^2]。 3. **Docker 容器内的路径映射问题** 在 Docker 部署场景下，如果 HTML 资源未正确挂载到容器内指定位置，可能会导致 Nginx 尝试不断寻找资源而陷入死循环[^3]。 4. **相对路径与绝对路径混淆** 使用相对路径而非绝对路径定义静态文件根目录也可能引起类似的错误。建议始终采用绝对路径来避免此类问题[^4]。 #### 解决方案 针对上述每种情况提供具体修复措施如下： ##### 方法一：调整 `try_files` 参数设置 修改 `location / {}` 块下的 `try_files` 行为，确保最终跳转目标能够有效终止递归调用链路： ```nginx server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html index.htm; # 修改此处参数防止重复查找 try_files $uri $uri/ =404; } } ``` ##### 方法二：排查并清理冗余监听配置 检查是否有其他不必要的站点配置也在占用同一端口号 (例如默认安装自带的一些示例模板)，必要时删除它们只保留当前所需的单一实例声明： ```bash rm -f /etc/nginx/conf.d/default.conf service nginx reload ``` ##### 方法三：验证 Docker 映射关系准确性 确认宿主机上的实际项目构建产物已成功复制至镜像对应存储区域；同时开放必要的网络通信权限允许外部访问测试接口功能正常运作。 ```dockerfile COPY ./dist /usr/share/nginx/html/ EXPOSE 8094 CMD ["nginx", "-g", "daemon off;"] ``` ##### 方法四：统一使用绝对地址表达形式 无论是在本地开发环境还是生产环境中部署应用服务都推荐全程保持一致性的全限定名引用方式减少潜在歧义风险提高可维护性和兼容度水平。 --- ### 示例修正后的完整 NGINX 配置样例 ```nginx server { listen 8094; server_name localhost; access_log /var/log/nginx/access.log; error_page 500 502 503 504 /50x.html; location = /50x.html { root /usr/share/nginx/html; } location / { alias /usr/share/nginx/html/dist/; index index.html index.htm; if (!-e $request_filename){ rewrite ^(.*)$ /index.html break; } } } ``` ---