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

React应用部署至GitHub Pages后显示空白页求助

React部署GitHub Pages空白+404错误排查方案

根据你提供的配置,问题核心出在路径配置错误和路由未适配子路径部署,以下是具体修复步骤:

1. 修正package.json中的homepage属性

你当前的homepage多了一层重复的myusername,GitHub Pages的正确格式应为:

"homepage": "https://myusername.github.io/myreponame",

错误的路径会导致build后的静态资源(JS/CSS)请求地址偏离实际部署位置,直接引发404。

2. 给HashRouter添加basename属性

由于应用部署在GitHub Pages的子路径(/myreponame)下,需要给HashRouter指定basename匹配仓库名称,确保路由和资源加载都基于正确的子路径:

// index.js
<HashRouter basename="/myreponame">
  <App />
</HashRouter>

3. 重新部署并验证

执行命令重新构建部署:

npm run deploy

部署完成后检查:

  • 浏览器控制台中静态资源的请求路径是否正确(不再包含多余的myusername)
  • 页面是否正常渲染,路由跳转是否可用

额外检查点

  • 确认GitHub仓库的Pages设置中,已选择gh-pages分支作为部署源
  • 若问题仍存在,清空浏览器缓存后重新加载页面

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.26 22:27:44