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

React应用部署后页面空白求助(本地运行正常)

React部署后页面空白排查方案
  • 检查路由配置:如果项目用了React Router,部署到静态服务器(如GitHub Pages、Netlify)时,若使用BrowserRouter,需要配置服务器将所有请求 fallback 到index.html;或者直接换成HashRouter,避免路径匹配问题。
  • 排查资源加载路径:打开浏览器控制台(F12)切换到Network标签,查看是否有404的JS/CSS资源。如果存在路径错误,在package.json中设置"homepage"字段:部署到根域名就设为"/",子路径部署(如GitHub Pages仓库)就设为"/仓库名/",本地测试打包可设为"."。
  • 查看控制台报错:切换到Console标签,检查是否有未捕获的错误(比如环境变量未配置、API请求失败、组件渲染报错等),这些都会导致页面空白。
  • 确认部署文件:确保你部署的是npm run build(或yarn build)生成的build文件夹内容,而非项目源码文件。
  • 关于private字段:这个字段主要控制npm包是否可发布,和页面空白问题关联不大,你改成false的操作没问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.01 23:35:19