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

