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

Angular应用部署至GitHub Pages后页面无显示,控制台报404资源加载错误

问题原因

所有静态资源404的核心原因是Angular构建时配置的base href路径与实际GitHub Pages的部署子路径不匹配。你当前的站点部署在/angular/子路径下,但默认构建的base href为根路径/,导致浏览器会从站点根目录请求js、css资源,而非从/angular/子路径下请求,因此触发404。

解决步骤
  • 方式一:构建时指定正确的子路径,执行构建命令时添加base-href参数:
    ng build --output-path docs --base-href /angular/
    如果你使用angular-cli-ghpages工具直接部署,执行部署命令时指定参数即可:
    ng deploy --base-href=/angular/
  • 方式二:如果你不想重新执行构建,可直接修改构建产物目录下的index.html,将<base href="/">改为<base href="/angular/">,再将修改后的产物上传到对应部署分支即可。
  • 检查GitHub Pages配置:进入仓库Settings→Pages页面,确认部署源的分支和目录对应你存放构建产物的位置,例如选择main分支的/docs目录,或gh-pages分支的根目录。
  • 配置完成后等待1-3分钟GitHub Pages生效,再访问站点即可正常加载资源。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.29 10:06:03