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

React项目部署GitHub Pages后页面空白,控制台报错求助

React应用部署到GitHub Pages后空白问题解决

核心问题定位

控制台的几个信息里,错误1和错误2是导致页面空白的关键:

  • 错误1:请求data.json返回404,说明部署后的页面找不到这个数据文件
  • 错误2:解析JSON时遇到<符号,是因为404返回的是HTML页面,不是预期的JSON数据,导致代码执行失败,页面无法渲染

那个Permissions-Policy的警告是浏览器特性相关,和页面空白无关,可以忽略;favicon.ico的404只是没有网站图标,不影响页面功能。

解决步骤

1. 修正数据文件的存放路径与请求方式

  • 把data.json移动到项目的public文件夹下(React项目中,public目录下的文件会被直接复制到build目录的根路径,部署后能被正确访问)
  • 在代码中请求数据时,使用React提供的环境变量拼接路径,确保本地开发和部署都能正常访问:
    fetch(`${process.env.PUBLIC_URL}/data.json`)
      .then(response => response.json())
      .then(data => {
        // 这里处理你的数据逻辑
      })
      .catch(error => console.error('数据加载失败:', error));
    

2. 重新部署应用

在项目根目录执行以下命令,重新构建并部署到GitHub Pages:

npm run deploy

3. (可选)修复网站图标问题

如果需要解决favicon.ico的404错误,把你的图标文件命名为favicon.ico,放到public文件夹下,然后在public/index.html中确保图标引用路径是:

<link rel="icon" href="%PUBLIC_URL%/favicon.ico" />

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.15 21:25:37