如何将React应用部署到自有服务器?解决域名空白及构建上传问题
生产环境部署操作指南
核心操作步骤
1. 构建产物存放路径
本地执行npm run build生成的build文件夹,完整上传到服务器上现有react-recipes项目的根目录下,无需移动到其他系统路径存放。
2. Express服务端逻辑调整
项目本身集成Express服务层,无需额外搭建静态文件服务,直接在现有服务入口文件完成以下配置:
- 挂载静态资源托管逻辑:引入
path模块后,在所有API路由之前添加静态文件挂载代码:app.use(express.static(path.join(__dirname, 'build'))) - 兼容前端路由:项目使用
react-router-dom实现单页应用路由,需在所有后端接口、GraphQL路由配置完成后,添加兜底路由规则,所有非接口请求统一返回build目录下的index.html,防止前端路由刷新触发404:app.get('*', (req, res) => res.sendFile(path.join(__dirname, 'build', 'index.html'))) - 修正服务监听绑定地址:将服务监听的绑定地址从默认
127.0.0.1修改为0.0.0.0,确保外部网络请求可接入服务,而非仅支持服务器本机回环访问。
3. 域名访问链路配置
- 配置Nginx反向代理:将已绑定域名的80/443端口请求,代理到Node服务实际运行的本地端口,不直接对外暴露Node服务端口。
- 核对防火墙与安全组规则:放行域名对应的80(HTTP)、443(HTTPS)端口入站规则,避免请求被拦截。
4. 白屏问题针对性排查
- 检查
package.json中的homepage字段:应用部署在域名根路径时,将字段值设置为".",防止构建后的静态资源引用路径错误触发白屏。 - 调整CORS配置:将正式域名加入服务端CORS允许列表,替换仅允许
localhost的本地开发配置,避免Apollo Client请求接口被拦截。 - 使用进程守护工具托管服务:通过
pm2启动Node服务,避免SSH会话断开后服务进程终止,可通过pm2 logs查看服务运行日志定位启动报错。
内容的提问来源于stack exchange,提问作者shayan khalighi
相关产品推荐
相关产品推荐

