Firebase项目中API站点Cookie报错问题求助

一、Cookie SameSite属性误用问题 #

原因 #

现代浏览器要求Cookie必须指定合规的SameSite属性，可选值为Lax、Strict，或搭配Secure（仅HTTPS环境生效）的None。你的API站点要么是Firebase托管默认Cookie未配置该属性，要么是自定义代码设置Cookie时使用了不符合规范的属性值。

解决办法 #

1. 针对Firebase托管自带Cookie
   在项目根目录的firebase.json中添加Header配置，强制给Cookie加上合规的SameSite属性：

{
  "hosting": {
    "headers": [
      {
        "source": "**",
        "headers": [
          {
            "key": "Set-Cookie",
            "value": "SameSite=Lax; Secure"
          }
        ]
      }
    ]
  }
}

配置完成后重新部署站点：firebase deploy --only hosting

2. 针对自定义代码设置的Cookie
   检查index.js里设置Cookie的代码，确保格式合规，示例如下：

// 设置符合规范的Cookie
document.cookie = "api_session=abc123; SameSite=Lax; Secure; Path=/";

注意：如果站点是HTTPS环境（Firebase托管默认启用HTTPS），使用SameSite=None时必须搭配Secure属性。

二、GA Cookie域名被拒绝问题 #

原因 #

Google Analytics的Cookie与站点域名绑定，你的API站点是Firebase项目下的第二个站点，域名与第一个正常站点不同，但GA配置仍沿用旧域名，或未将API站点域名加入GA允许列表，导致浏览器拒绝写入Cookie。另外，若API站点为纯接口服务，加载GA代码本身无意义，反而会引发报错。

解决办法 #

1. 调整GA后台配置
   登录Google Analytics后台，找到对应媒体资源：

• 进入「管理」→「媒体资源设置」
• 找到「Cookie域」选项，设置为auto（自动适配当前站点域名），或直接填写API站点的完整域名（如your-api-domain.com或xxx.web.app）

2. 修正前端GA嵌入代码
   检查index.html里的GA初始化代码，确保cookie_domain参数设置正确：

gtag('config', '你的GA跟踪ID', {
  cookie_domain: 'auto'
});

3. 直接移除GA代码（推荐）
   既然这是API站点，主要供客户端程序调用而非用户访问页面，完全不需要加载Google Analytics统计代码。直接删除index.html里的GA嵌入片段，可彻底解决该Cookie报错问题。

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