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

