You need to enable JavaScript to run this app. AWS ECS路径路由负载均衡场景下React应用的Nginx配置方法
优惠活动
大模型
产品
解决方案
定价
更多

AWS ECS路径路由负载均衡场景下React应用的Nginx配置方法

同域名路径路由模式下React前端部署Nginx配置问题解决

我开发了一套由两个容器组成的应用:

  • 基于Express.js的Node.js后端服务,标记为app-server
  • 基于create-react-app构建的React前端客户端app-client,容器内置Nginx服务,已参考相关技术文章为应用的/api请求配置反向代理。

两个服务完成容器化后部署在AWS ECS Fargate上,规划统一托管在同一域名example.com下,通过不同路径区分服务:后端服务对应路径/app-server,前端服务对应路径/app-client,用户可通过https://example.com/app-client访问应用,后续还计划通过基于路径的路由规则在同一域名下托管更多应用。

为实现该架构,我在EC2应用负载均衡器(ALB)的监听器上配置了如下转发规则:

IF
- Path is: /app-client*
- Host is: example.com

THEN
- Forward to
  - app-client-service-alb-h: 1 (100%)
  - Group-level stickiness: Off

后续也测试过将路径规则改为不带*的/app-client,问题没有变化。

目前我已经完成了Express后端服务的适配调整,但React应用在路径转发场景下始终无法正常运行,页面显示空白(该应用此前直接绑定独立域名如http://app-client.com时可正常运行)。排查后判断问题出在Nginx配置环节:请求的URL路径是正确的,但对应路径下找不到.html、.js、.css等静态资源文件。

当前前端的Dockerfile如下:

FROM node:11.5.0 as builder

WORKDIR /usr/src/app

ADD ./ /usr/src/app

RUN npm install && \
    npm run build


# ------------------------------------------------------
# 生产构建阶段
# ------------------------------------------------------
FROM nginx:1.16.0-alpine

COPY --from=builder /usr/src/app/build/ /usr/share/nginx/html

RUN rm -rf /etc/nginx/conf.d
COPY conf /etc/nginx

EXPOSE 80

CMD ["nginx", "-g", "daemon off;"]

初始的Nginx配置如下:

server {

  listen 80;

  server_name example.com;

  location /api {
    proxy_pass https://example.com/app-server;
    proxy_pass_request_headers on;
  }   

  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;
  }

}

我也调整过React应用package.json中的homepage字段,先后设置为/app-client与https://example.com/app-client,此时浏览器发起的静态资源请求路径是正确的,例如https://example.com/app-client/static/js/main.32859df6.chunk.js,但该地址下没有匹配的资源,导致页面空白;我也尝试过移除package.json中的homepage配置,问题没有得到解决。

后续我尝试将Nginx的位置块改为匹配/app-client路径,配置静态资源映射与SPA路由规则,仍然无法正常加载,当时的配置如下:

location /app-client {
    root   /usr/share/nginx/html;
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
}

我参考了多篇同场景的技术教程、开源配置示例尝试调整,都没有解决问题,最后通过调整Nginx配置解决了问题,正确配置如下:

server {

  listen 80;

  # 全局静态文件根目录必须放在location外层配置,否则Nginx会错误到/etc下的默认路径查找文件
  root /usr/share/nginx/html;

  # 匹配/app-client开头的请求,重写去掉前缀后匹配本地静态文件
  location /app-client {
    rewrite ^/app-client(?:/(.*))?$ /$1;
  }

  # 后端服务/api请求反向代理
  location /api {
    # proxy_pass末尾的/api段需要和后端实际路由前缀匹配,我的后端路由带/api前缀,因此这里必须加上
    proxy_pass https://example.com/app-server/api; 
    proxy_pass_request_headers on;
  } 
  
  location / {
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
  }

}

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.10 00:06:04