You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在Plesk Obsidian上部署React应用出现错误寻求解决方案

Plesk Obsidian 部署 React 应用报错解决指南
  • 第一步:校验 Node.js 版本适配性
    React 生产部署要求 Node.js 版本不低于 14.0.0,优先使用 16.x、18.x 等 LTS 版本。你可以进入对应站点的 Node.js 设置 页面,在版本下拉菜单选中符合要求的版本后,点击应用保存配置。
  • 第二步:修正站点目录与启动配置
    • 文档根目录需要设置为 React 项目打包后生成的 build 文件夹路径
    • 若使用 Node.js 托管服务,应用启动文件需配置为对应静态服务入口(如使用 serve 托管则填server.js,不要使用默认的 app.js)
  • 第三步:重新安装项目依赖
    不要手动上传本地的 node_modules 文件夹,直接在站点的 Node.js 设置 页面点击安装依赖按钮,由 Plesk 在服务器环境下安装所有依赖包,安装完成后点击重启应用生效。
  • 第四步:校验项目构建配置
    打开项目根目录下的 package.json 文件,确认 build 脚本配置正确,参考配置如下:
{
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  }
}

配置修改完成后点击 Node.js 设置页面的运行脚本,选择 build 执行构建操作即可。

  • 补充:路由刷新404问题处理
    如果部署后首页可正常访问、子路由刷新报错404,可在 Plesk 面板的 URL重写 功能中添加 SPA 路由重定向规则,将所有请求定向到 build 目录下的 index.html。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.04 08:06:02