Github Pages自定义域主页正常，其他页面404问题排查求助

已验证的解决方案 #

• 将路由组件中的<BrowserRouter>替换为<HashRouter>（Github Pages不支持BrowserRouter的前端路由模式）
• 修改package.json中的homepage字段，确保其包含#，例如："homepage": "https://mywebsite.com/#" 或直接设置为"homepage": "#"

问题解答 #

1. 为何本地可正常访问About页面，部署到gh-pages后却出现404？ #

本地开发环境（如npm start启动的webpack-dev-server）会拦截所有路由请求，转发到React应用的入口文件index.html，由前端路由处理页面跳转。但Github Pages是静态文件托管服务，当直接访问mywebsite.com/about这类路径时，服务器会尝试寻找对应目录下的静态文件，而该路径实际不存在，因此返回404错误。

2. 如何实现添加自定义域名时自动构建站点？ #

按照Github官方文档的指引，可通过以下步骤触发自动重建：

• 确认本地Git的提交作者信息（user.name和user.email）与Github账号匹配，确保权限正常
• 进入Github仓库的「Pages」设置页面，先移除当前配置的自定义域名，点击保存；等待片刻后重新添加自定义域名并保存，此操作会触发站点自动重建
• 若上述操作无效，可手动提交一个空更改（例如修改README.md添加一个空格后提交），触发Github Pages重新部署

内容的提问来源于stack exchange，提问作者Evan Denmark