Chrome扩展MV3沙箱中document.cookie读取报错解决方案咨询

问题核心 #

Chrome扩展MV3的沙箱机制默认强制隔离环境，沙箱页面处于无同源状态，无法直接读取document.cookie；同时MV3不允许在manifest的sandbox配置中直接添加allow-same-origin（会导致清单加载失败），即便在iframe上同时设置allow-scripts allow-same-origin，也无法突破沙箱的同源限制。

解决方案：通过消息传递委托信任上下文处理Cookie操作 #

沙箱页面的核心作用是隔离不受信任的脚本，因此不应直接处理Cookie或敏感API调用。正确的做法是将这类操作委托给扩展的信任上下文（如popup或background），通过postMessage完成数据交互：

1. 调整manifest.json配置 #

保持沙箱的隔离配置，无需添加allow-same-origin：

{
  "manifest_version": 3,
  "name": "foo",
  "version": "1.0",
  "action": {
    "default_popup": "popup.html"
  },
  "sandbox": {
    "pages": [
      "sandbox.html"
    ]
  },
  "content_security_policy": {
    "sandbox": "sandbox allow-scripts",
    "extension_pages": "script-src 'self'; object-src 'none'"
  }
}

2. 修改popup.html，添加消息监听 #

在popup中监听沙箱页面的请求，负责处理Cookie读取或Google Sheets API调用：

<html>
<body>
  <iframe id="sandboxFrame" src="sandbox.html"></iframe>
  <script>
    const sandboxFrame = document.getElementById('sandboxFrame');
    
    // 监听沙箱页面的消息请求
    window.addEventListener('message', (event) => {
      if (event.source === sandboxFrame.contentWindow && event.data.type === 'GET_COOKIE') {
        // 读取Cookie并返回给沙箱页面
        const cookieData = document.cookie;
        sandboxFrame.contentWindow.postMessage({
          type: 'COOKIE_DATA',
          data: cookieData
        }, '*');
      }
    });
  </script>
</body>
</html>

3. 修改sandbox.html，通过消息获取Cookie #

沙箱页面不再直接读取document.cookie，而是向popup发送请求并接收返回结果：

<html>
<body>
  <script>
    // 向popup发送Cookie获取请求
    window.parent.postMessage({ type: 'GET_COOKIE' }, '*');
    
    // 接收popup返回的Cookie数据
    window.addEventListener('message', (event) => {
      if (event.data.type === 'COOKIE_DATA') {
        console.log('获取到的Cookie:', event.data.data);
        // 在此处继续处理Google Sheets API逻辑，例如引入client.js后使用Cookie数据
      }
    });
  </script>
</body>
</html>

针对Google Sheets API的额外说明 #

如果Google Sheets的client.js依赖Cookie完成认证，建议将API的初始化和调用逻辑完全放在popup或background等信任上下文中，沙箱页面仅负责展示结果或传递用户操作，避免在沙箱中直接加载第三方脚本带来的安全风险。

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