在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)
- 文档根目录需要设置为 React 项目打包后生成的
- 第三步:重新安装项目依赖
不要手动上传本地的 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
相关产品推荐
相关产品推荐

