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

更换GoDaddy域名后GitHub Pages部署的网站显示空白

自定义域名部署GitHub Pages页面空白排查方案

针对更换GoDaddy域名后GitHub Pages页面空白(资源已加载但无内容)的问题,按以下步骤排查:

1. 修正Vite的base配置

根域名部署时,vite.config.js中的base应设为'/',而非完整域名。错误配置成完整域名会导致资源路径重复拼接,引发渲染异常。

正确配置示例:

export default defineConfig({
  base: '/',
  // 其余配置项...
})

2. 开启GitHub Pages HTTPS强制跳转

进入仓库「Settings」→「Pages」页面,确保「Enforce HTTPS」选项已勾选。自定义域名需GitHub生成SSL证书,未开启HTTPS可能导致资源加载后渲染阻塞(无报错但页面空白)。

3. 配置前端路由重定向(若使用history模式)

如果项目用了Vue Router/React Router等的history模式,需在仓库根目录创建_redirects文件,写入:

/* /index.html 200

提交该文件到仓库,GitHub Pages会将所有请求重定向到index.html,避免路由匹配失败导致页面空白。

4. 强制刷新清除缓存

按下Ctrl+Shift+R(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新页面,清除浏览器缓存的旧资源或配置。

5. 验证DNS配置有效性

从提供的DNS截图确认:

  • A记录指向GitHub Pages官方IP(185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153)
  • CNAME记录指向你的GitHub默认域名(GilbertKrantz.github.io)
    可通过nslookup unipal.online命令验证域名解析是否生效,DNS生效通常需1-24小时。

6. 检查控制台隐藏报错

打开浏览器开发者工具「Console」面板,切换到「Verbose」级别,查看是否有被忽略的警告或初始化错误(比如CSP策略限制)。


内容的提问来源于stack exchange,提问作者WIlbert Chandra

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.19 18:50:07