You need to enable JavaScript to run this app. 如何配置K8s Ingress适配react-router-dom解决动态子路由404问题
优惠活动
大模型
产品
解决方案
定价
更多

如何配置K8s Ingress适配react-router-dom解决动态子路由404问题

问题原因与解决方案

该404问题由两层配置共同导致,分别修复即可恢复正常访问。

一、K8s Nginx Ingress 配置修正

现有Ingress配置存在3处问题:

  • annotation前缀拼写错误:kubecnginx.ingress.kubernetes.io/ssl-redirect多了冗余字符c,正确前缀为nginx.ingress.kubernetes.io/ssl-redirect
  • 路径匹配规则未显式声明pathType,低版本v1beta1 API默认的ImplementationSpecific规则无法正确匹配带动态参数的前端路由
  • 冗余配置了/video/*路径,与已有/前缀路径功能重复,易造成匹配冲突

修正后的完整Ingress配置如下:

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
    name: ingress-service
    annotations:
        kubernetes.io/ingress.class: nginx
        cert-manager.io/cluster-issuer: "letsencrypt-prod"
        nginx.ingress.kubernetes.io/ssl-redirect: 'true'
spec:
    tls:
        - hosts:
            - website.app
            - www.website.app
          secretName: website-app
    rules:
        - host: website.app
          http:
            paths:
                - path: /
                  pathType: Prefix
                  backend:
                    serviceName: frontend-cluster-ip-service
                    servicePort: 3000
                - path: /api/
                  pathType: Prefix
                  backend:
                    serviceName: backend-cluster-ip-service
                    servicePort: 5000
                - path: /payments/
                  pathType: Prefix
                  backend:
                    serviceName: backend-cluster-ip-service
                    servicePort: 5000
                - path: /streaming/
                  pathType: Prefix
                  backend:
                    serviceName: streaming-ip-service
                    servicePort: 3000
        - host: www.website.app
          http:
            paths:
                - path: /
                  pathType: Prefix
                  backend:
                    serviceName: frontend-cluster-ip-service
                    servicePort: 3000
                - path: /api/
                  pathType: Prefix
                  backend:
                    serviceName: backend-cluster-ip-service
                    servicePort: 5000
                - path: /payments/
                  pathType: Prefix
                  backend:
                    serviceName: backend-cluster-ip-service
                    servicePort: 5000
                - path: /streaming/
                  pathType: Prefix
                  backend:
                    serviceName: streaming-ip-service
                    servicePort: 3000

配置说明:/路径声明pathType: Prefix后,可匹配所有前端路由路径,无需单独为/video类路由配置规则

二、前端容器Nginx SPA路由兜底配置

即使Ingress将请求正确转发到前端服务,前端容器内的默认Nginx配置会直接按请求路径查找静态文件,找不到时返回404。React为单页应用,所有路由逻辑由前端JS处理,服务端只需统一返回index.html即可。

对应配置调整:

根目录Dockerfile

将前端构建产物打包进Nginx镜像时,替换默认Nginx配置:

FROM node:13.12.0-alpine as build
WORKDIR /app
ENV PATH /app/node_modules/.bin:$PATH
COPY package.json ./
COPY yarn.lock ./
RUN yarn install --frozen-lockfile
RUN yarn add react-scripts@3.4.1 -g --silent
COPY . ./
RUN yarn run build

# 生产环境阶段
FROM nginx:stable-alpine
COPY --from=build /app/build /usr/share/nginx/html
RUN rm /etc/nginx/conf.d/default.conf
COPY nginx/nginx.conf /etc/nginx/conf.d
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

容器内Nginx配置(路径:nginx/nginx.conf,位于项目根目录)

server {
  listen 80;
  location / {
    root   /usr/share/nginx/html;
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
  }
  error_page 500 502 503 504 /50x.html;
  location = /50x.html {
    root  /usr/share/nginx/html;
  }
}

核心说明:配置中的try_files $uri $uri/ /index.html;为单页应用专属兜底规则,当Nginx找不到请求路径对应的静态资源时,统一返回根目录的index.html,交由前端React Router处理路由跳转

三、验证流程

  1. 应用修改后的Ingress配置,确认Ingress日志无路径匹配拒绝记录
  2. 重新构建前端镜像,更新对应Deployment后,直接访问www.website.app/video/123即可正常加载视频路由组件
  3. 原有React路由代码无需做任何调整

内容的提问来源于stack exchange,提问作者Adrian Coutsoftides

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 19:54:05