Unity WebGL部署GitHub Pages遇gzip解析错误，求解决方案

方法一：配置GitHub Pages添加gzip响应头 #

GitHub Pages默认不会自动为.gz文件添加Content-Encoding: gzip响应头，你可以通过以下两种方式配置：

方式1：使用Jekyll配置文件 #

在项目根目录创建或修改_config.yml文件，添加以下内容：

# 确保Build文件夹被Jekyll处理
include: [Build]

# 为.gz文件设置响应头
defaults:
  - scope:
      path: "Build/*.gz"
    values:
      headers:
        Content-Encoding: gzip

提交该文件到Git分支，重新部署GitHub Pages即可生效。

方式2：通过GitHub Actions部署时设置响应头 #

创建.github/workflows/deploy.yml文件，写入以下部署脚本：

name: Deploy to GitHub Pages

on:
  push:
    branches: [ main ] # 替换为你的部署分支

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Configure GitHub Pages
        uses: actions/configure-pages@v4
        
      - name: Upload build artifacts with custom headers
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./
          headers: |
            Build/*.gz:
              Content-Encoding: gzip
              
      - name: Deploy to Pages
        uses: actions/deploy-pages@v4

提交该文件后，每次推送代码到指定分支，Action会自动部署并为.gz文件添加正确的响应头。

方法二：修改Unity WebGL构建选项（更简单） #

如果不想配置服务器响应头，可以直接在Unity中关闭构建压缩：

• 打开Unity，进入File > Build Settings
• 切换到WebGL平台，点击Player Settings
• 在Player > Publishing Settings面板中，找到Compression Format选项，选择Disabled
• 重新构建WebGL项目，将新的构建文件推送到Git分支并部署到GitHub Pages，项目即可正常运行

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