Chrome转Safari扩展无法获取Web应用Cookie的认证问题求助

问题核心 #

你的扩展在Chrome中用service worker后台能自动携带Cookie，但转成Safari后失效，根源在于Safari对service worker的跨站Cookie隔离机制更严格：

• Safari的service worker属于独立的隔离上下文，默认无法访问Web应用的跨站Cookie（即使用户已登录），开启「防止跨站追踪」时限制更明显
• 第三方扩展用的是传统background page（HTML页面加载脚本），这种上下文遵循普通网页的Cookie规则，能正常获取并携带Web应用的Cookie

解决步骤：将后台从service worker改为background page #

1. 修改原Chrome扩展的manifest.json #

把原来的service worker配置替换成background page：

// 原配置
"background": {
  "service_worker": "background.js"
}

// 修改后
"background": {
  "page": "background.html"
}

2. 创建background.html文件 #

在扩展根目录新建该文件，引入你的后台脚本：

<!DOCTYPE html>
<html>
<body>
  <script src="background.js"></script>
</body>
</html>

3. 重新转换或调整Xcode项目 #

• 如果你还没转换，用xcrun safari-web-extension-converter重新转换扩展，工具会自动识别background page配置
• 如果已经有转换好的Xcode项目：
  1. 打开Xcode项目，找到扩展目标的Info.plist
  2. 定位到SFSafariWebExtension字段，确保Background Page指向你的background.html文件
  3. 或者在Xcode的「Web Extension」设置面板中，直接指定Background Page路径

4. 验证效果 #

构建并运行扩展后，进入Safari的Develop > Web Extension Background Content：

• 应该能看到加载了background.html的页面，开发者工具标签完整
• 从后台控制台发起fetch请求时，Cookie会自动携带，API请求能正常授权

额外注意事项 #

• 确保Web应用的Cookie配置正确：如果是跨站请求，Cookie必须设置SameSite=None和Secure属性
• 后台脚本的fetch请求建议显式加上credentials: 'include'，兼容更多场景：

  fetch('https://your-api-domain.com/api', {
    credentials: 'include'
  })
  

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