如何修复Unity WebGL构建中的“Unable to parse Build”错误？

1. 启用S3静态网站托管 #

• 进入目标S3存储桶的「属性」标签，找到「静态网站托管」模块
• 选择「启用」，设置索引文档为index.html，错误文档同样设为index.html（适配Unity WebGL单页路由逻辑）
• 保存后，使用S3生成的静态网站专属访问地址打开项目，不要直接访问index.html的对象URL

2. 修正文件MIME类型 #

S3默认无法识别Unity WebGL的特殊文件类型，需手动配置：

• 针对不同后缀的文件设置对应MIME类型：
  • .wasm → application/wasm
  • .unityweb、.data → application/octet-stream
  • .js → application/javascript
  • .html → text/html
• 可通过AWS CLI批量修改，示例命令（替换为你的存储桶名）：

  # 批量设置.wasm文件MIME类型
  aws s3 cp s3://your-bucket/ s3://your-bucket/ --recursive --content-type "application/wasm" --exclude "*" --include "*.wasm"
  

  重复上述命令，替换后缀和content-type即可处理其他文件类型

3. 配置CORS规则 #

若项目存在跨域请求，需设置存储桶CORS：

• 进入存储桶「权限」→「跨域资源共享(CORS)」，添加以下规则：

  [
      {
          "AllowedHeaders": ["*"],
          "AllowedMethods": ["GET", "HEAD"],
          "AllowedOrigins": ["*"],
          "ExposeHeaders": []
      }
  ]
  

  生产环境建议将AllowedOrigins限制为你的业务域名，提升安全性

4. 检查Unity构建配置 #

• 打开Unity编辑器，进入File → Build Settings → WebGL → Player Settings
• 确认「WebGL Template」为默认模板，避免自定义模板的路径错误
• 开启「Publishing Settings」中的「Enable WebGL Debugging」，获取更详细的错误日志后重新构建上传

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