如何配置单Spartacus应用对接单个BA Hybris下多个Web Store且会话不串扰

一、Spartacus 端核心配置 #

所有配置修改均在应用根模块的provideConfig注入逻辑中完成：

• 多站点上下文配置
  声明所有对接的baseSite标识，开启URL参数动态识别规则，示例配置如下：

  provideConfig({
    context: {
      // 填入所有需要对接的baseSite编码
      baseSite: ['electronics', 'apparel-uk', 'apparel-de'],
      // 启用路径参数识别，优先级从左到右
      urlParameters: ['baseSite', 'language', 'currency'],
      // 配置路径匹配规则，示例取URL第一段为baseSite
      urlMatchingPatterns: ['/:baseSite/:language/:currency/:path**', '/:baseSite/:path**']
    }
  })
  

• 会话隔离核心配置
  给不同baseSite的本地存储、认证令牌设置独立前缀，避免同域名下存储内容互相覆盖：

  provideConfig({
    auth: {
      storageSync: {
        keys: {
          // 动态给存储key添加当前baseSite前缀
          prefix: (context) => `${context.baseSite}-`
        }
      }
    },
    occ: {
      // 确保所有OCC请求自动携带当前上下文的baseSite参数
      prefix: '/occ/v2/${baseSite}/'
    }
  })
  

• 可选配置：如果是按域名区分不同Web Store，可新增域名和baseSite的映射规则，无需在URL加路径前缀。

二、方案潜在影响 #

• 首屏加载耗时小幅增加：需先完成上下文识别、拉取对应Base Store的站点配置后才会渲染页面，较单站点新增1-2个接口请求耗时。
• 本地存储占用上升：每个Base Store的会话信息、购物车缓存、浏览历史独立存储，接入站点越多，localStorage占用越大。
• 样式维护成本提升：如果不同Web Store的视觉风格差异较大，需要做样式按站点隔离，避免跨站点样式污染。
• 测试工作量增加：新功能迭代需要覆盖所有接入的Base Store场景，无法仅验证单站点。

三、Hybris（BA）侧配套配置 #

• OAuth客户端配置：要么给每个Base Store分配独立的OAuth客户端，要么在公共客户端的权限配置中放开所有对接baseSite的访问权限，确保令牌只能访问对应站点的资源。
• 会话不串扰核心配置：给每个Base Store的会话Cookie设置独立的Path属性或名称前缀，避免同域名下Cookie互相覆盖，同时开启Cookie的SameSite属性规避跨站风险。
• CORS规则配置：允许Spartacus的访问域名调用所有对应Base Store的OCC接口，同时开启Access-Control-Allow-Credentials配置，确保Cookie能正常携带。
• 站点基础配置：在Hybris后台给每个Base Store配置独立的类目目录、支付网关、配送规则、支持的语言/货币，确保OCC接口能按baseSite参数返回对应站点的业务数据。
• 接口逻辑校验：排查所有自定义OCC接口，确保没有硬编码单baseSite的逻辑，所有接口都能根据请求路径中的baseSite参数返回对应数据。

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