Unity WebGL部署GitHub Pages失败：无法打开global-metadata.dat

核心问题分析 #

从报错日志来看，关键问题是运行时无法找到Unity WebGL导出的核心文件（global-metadata.dat、RuntimeInitializeOnLoads.json、GlobalGameManagers等），同时存在加载配置缺失的情况。Itch.io可正常运行说明本地导出文件完整，问题出在GitHub Pages的文件部署环节。

针对性解决步骤 #

1. 修复Git LFS导致的文件缺失 #

如果使用Git LFS存储WebGL导出的大文件（如.dat、.wasm、Il2CppData目录下的文件），GitHub Pages默认不会自动拉取LFS文件，只会保留占位符文本，导致运行时文件找不到：

• 若文件大小符合Git限制（单文件<100MB，仓库总大小<1GB）：
  • 执行git lfs untrack <目标文件/目录路径>取消LFS跟踪
  • 重新添加文件：git add <目标文件/目录路径>
  • 提交并推送：git commit -m "Move LFS files to regular Git" && git push
• 若文件超出Git限制：
  • 创建GitHub Actions工作流，在部署步骤中加入git lfs pull拉取完整文件，再推送至gh-pages分支。

2. 验证并修复文件提交完整性 #

• 检查.gitignore文件，确保没有排除Il2CppData目录、.dat、.json、GlobalGameManagers等核心文件，如有对应规则需删除。
• 直接查看GitHub仓库的Build目录，确认Il2CppData子目录、所有.json和.dat文件都已完整提交，无缺失。

3. 修正WebGL加载路径配置 #

报错中的no boot config - using default values说明加载路径不匹配：

• 重新导出WebGL时，在Unity Player Settings中设置Base URL为你的GitHub Pages项目路径（如/PopTeacher/）。
• 或手动修改导出后的index.html，调整Unity加载器的资源路径，确保指向正确的Build目录下的文件。

4. 手动验证文件可访问性 #

直接访问GitHub Pages上的核心文件URL（如https://rogewood.github.io/PopTeacher/Build/Il2CppData/Metadata/global-metadata.dat），若返回404，说明文件未成功部署，需重新检查提交和推送流程。

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