React项目部署Github Pages无内容显示问题求助
修正
package.json的homepage配置:
原配置存在冗余,应改为"homepage": "https://Jallard2.github.io/wordleonline",或更简洁的"homepage": "/wordleonline",确保静态资源能正确加载。调整
BrowserRouter的basename参数:
将<BrowserRouter basename={"/Jallard2.github.io/wordleonline"}>改为<BrowserRouter basename={"/wordleonline"}>,basename仅需填写仓库对应的路径部分,无需包含域名,否则会导致路由匹配错误。重新构建并部署:
运行npm run build生成最新构建文件,若使用gh-pages工具,先确保已安装(npm install gh-pages --save-dev),在package.json的scripts中添加"deploy": "gh-pages -d build",再执行npm run deploy完成部署。检查Github Pages仓库设置:
进入仓库的Settings -> Pages页面,确认部署分支为gh-pages、部署目录选择/root,保存后等待几分钟让页面生效(Github Pages部署存在延迟)。查看浏览器控制台定位错误:
打开Github Pages页面按F12,查看Console面板的报错信息。若出现静态资源404,说明homepage配置有误;若为路由相关错误,检查basename是否正确。临时替代方案:
若BrowserRouter问题无法快速解决,可换成HashRouter,无需配置basename,哈希路由的路径不会与Github Pages静态资源路径冲突,适配静态托管场景。
内容的提问来源于stack exchange,提问作者Happyface456

