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
相关产品推荐
相关产品推荐

