部署到GitHub Pages的React应用突然无法正常运行如何解决?
问题排查及解决步骤
- 首先修正
package.json中homepage字段的协议:当前配置为http协议,GitHub Pages 全站默认强制跳转https,混合协议会触发资源加载拦截,将homepage值改为https://asaroz.github.io/DCI_Hackathon_TeamE/ - 清理本地缓存后重新部署:
- 删除本地
node_modules文件夹和package-lock.json文件 - 执行
npm install重新安装依赖 - 执行
npm run deploy重新触发部署流程
- 删除本地
- 验证构建产物路径:本地执行
npm run build后,检查build文件夹内的index.html文件,确认所有静态资源引用路径前缀均为/DCI_Hackathon_TeamE/,无直接指向根路径/的资源引用 - 检查仓库 Pages 配置:进入仓库
Settings > Pages页面,确认部署源设置为gh-pages分支的/root目录,未配置错误的源分支或路径 - 排除服务端缓存影响:GitHub Pages 部署完成后存在最长10分钟的缓存周期,部署后等待10分钟,使用浏览器无痕模式访问测试,避免本地缓存干扰
- 可选适配方案:如果以上步骤仍未解决,可修改
package.json的build脚本,手动指定 PUBLIC_URL:"scripts": { "build": "PUBLIC_URL=/DCI_Hackathon_TeamE react-scripts build", // 其余脚本保持不变 }
内容的提问来源于stack exchange,提问作者Asaroz
相关产品推荐
相关产品推荐

