GitHub Pages部署的React应用深度链接域名验证问题求助

一、解决.well-known/assetlinks.json访问404的问题 #

• 确认项目根目录的.nojekyll文件已提交到GitHub仓库，该文件用于告知GitHub Pages不要用Jekyll处理静态文件，避免隐藏下划线开头的目录。
• 检查构建后目录结构：create-react-app会将public下的文件复制到build目录，但如果.well-known文件夹未被正确复制，修改package.json的build脚本强制复制：
  • macOS/Linux环境修改build命令：

    "scripts": {
      "build": "react-scripts build && cp -r public/.well-known build/"
    }
    

  • Windows环境修改build命令：

    "scripts": {
      "build": "react-scripts build && xcopy public\\.well-known build\\.well-known /E /I"
    }
    

• 重新构建部署：运行npm run build，将build目录内容推送到GitHub Pages对应分支（通常是gh-pages）。
• 触发重新部署：在GitHub仓库的Settings -> Pages页面点击"Save"按钮，强制刷新缓存。

二、解决自定义404路由在GitHub Pages不生效的问题 #

• 在public目录下创建404.html文件，内容完全复制public/index.html。GitHub Pages找不到对应路径时会返回该文件，React路由系统会接管并渲染你定义的<Route path="*" element={...} />组件。
• 确保React路由使用BrowserRouter而非HashRouter，BrowserRouter需要服务器路径转发支持，404.html的配置刚好满足这个需求。
• 重新构建部署后，访问example.com/asdf这类不存在的路径即可显示自定义404页面。

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