AWS ECS路径路由负载均衡场景下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

