如何配置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处理路由跳转
三、验证流程
- 应用修改后的Ingress配置,确认Ingress日志无路径匹配拒绝记录
- 重新构建前端镜像,更新对应Deployment后,直接访问
www.website.app/video/123即可正常加载视频路由组件 - 原有React路由代码无需做任何调整
内容的提问来源于stack exchange,提问作者Adrian Coutsoftides
相关产品推荐
相关产品推荐

