解决Firebase托管Godot游戏的Cross Origin Isolation与SharedArrayBuffer问题

问题根源 #

你的Firebase Hosting头配置的source规则错误，导致关键的跨域隔离头没有应用到Godot项目的核心文件（如index.html、index.js、wasm文件）上。另外，手动添加的WebAssembly代码属于多余操作，反而可能干扰Godot的正常加载流程。

修复步骤 #

1. 修正Firebase Hosting的头配置
   替换你的firebase.json为以下内容，确保跨域头应用到所有项目文件：

   {
     "hosting": {
       "public": "public",
       "ignore": [
         "firebase.json",
         "**/.*",
         "**/node_modules/**"
       ],
       "headers": [
         {
           "source": "**",
           "headers": [
             {
               "key": "Cross-Origin-Embedder-Policy",
               "value": "require-corp"
             },
             {
               "key": "Cross-Origin-Opener-Policy",
               "value": "same-origin"
             }
           ]
         }
       ]
     }
   }
   

   • 把headers配置移到hosting节点下，确保只对当前托管站点生效
   • 将source改为**，匹配所有文件（原配置**/.*仅匹配隐藏文件，无法覆盖Godot的核心资源）
   • 移除Cross-Origin-Resource-Policy，require-corp已足够满足跨域隔离要求，多余的头可能引发冲突

2. 移除不必要的代码

   • 删除你手动添加的WebAssembly实例化代码段：

     <script>
             var module = new WebAssembly.Module(buffer);
             var instance = new WebAssembly.Instance(module, { js: { js: () => {} } }, {});
     </script>
     

     Godot Web构建会自动处理Wasm模块的加载，这段代码完全多余。
   • 移除index.js脚本标签的crossorigin="anonymous"属性：

     <script src="index.js"></script>
     

     同域资源无需跨域标识，该属性会在require-corp规则下引发加载问题。

3. 重新部署并验证

   • 运行命令重新部署Firebase Hosting：

     firebase deploy --only hosting
     

   • 打开浏览器开发者工具（F12），切换到Network标签，刷新页面后检查index.html、index.js、godot.wasm等文件的响应头，确认以下两个头存在：
     • Cross-Origin-Embedder-Policy: require-corp
     • Cross-Origin-Opener-Policy: same-origin
   • 清除浏览器缓存（Ctrl+Shift+R）后重新访问页面，错误应该会消失。

额外检查 #

• 确认Godot项目的Web构建输出目录正确对应firebase.json中的public字段（即所有构建文件都放在public文件夹下）
• 确保Firebase CLI是最新版本，避免旧版本的配置解析问题：

  npm install -g firebase-tools
  

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