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

部署到GitHub Pages的React应用突然无法正常运行如何解决?

问题排查及解决步骤

  • 首先修正package.json中homepage字段的协议:当前配置为http协议,GitHub Pages 全站默认强制跳转https,混合协议会触发资源加载拦截,将homepage值改为https://asaroz.github.io/DCI_Hackathon_TeamE/
  • 清理本地缓存后重新部署:
    1. 删除本地node_modules文件夹和package-lock.json文件
    2. 执行npm install重新安装依赖
    3. 执行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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.26 01:15:09