You need to enable JavaScript to run this app. 如何在Nginx VPS的子路径下部署NodeJS+Express+React应用?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Nginx VPS的子路径下部署NodeJS+Express+React应用?

问题根因

  1. 刷新报cannot get /location/page1是因为前端路由是客户端侧控制的,Express没有对应匹配/location/page1的路由规则,直接返回404响应。
  2. 修改为app.use("/location/*")/app.use("*")后出现的Uncaught SyntaxError: Unexpected token '<',是因为所有请求(包括请求/location/main.js这类静态资源)都被匹配到,统一返回了index.html的内容,浏览器把HTML内容当作JS解析就会抛出这个语法错误。

方案1:保留Express托管静态资源的修复方式

保持现有的静态资源配置不变,在静态资源配置之后新增兜底路由即可,注意配置顺序不能反:

// 原有静态资源配置保留,放在最前面
app.use("/location/",  express.static(path.join(__dirname, './client/public/dist/')))

// 新增兜底路由:所有/location开头的GET请求,静态资源没匹配到就返回index.html
app.get("/location/*", (req, res) => {
  res.sendFile(path.join(__dirname, './client/public/dist/index.html'));
})

改完重启Express服务就能解决刷新404的问题,也不会出现JS解析错误。

方案2:更简单的Nginx直接托管方案

不需要Express托管静态资源,直接让Nginx处理React构建产物,性能更高配置更简单,Express只需要处理后端接口请求即可,Nginx配置如下:

location /location {
    # 这里填你VPS上React构建产物dist目录的绝对路径
    alias /www/server/react-project/dist;
    # 核心配置:找不到静态资源就返回子路径下的index.html,交给前端路由处理
    try_files $uri $uri/ /location/index.html;
}

# 如果有后端接口,单独配置接口代理即可,比如接口都在/location/api路径下
location /location/api {
    proxy_pass http://localhost:5002/location/api;
}

这个方案不需要修改Express的静态资源相关配置,直接关掉Express的静态资源托管逻辑就行,运维更简单。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.18 08:54:02