Spartacus 2.0配置多站点后非SSR构建下购物车API币种参数错误如何解决？

问题核心特征 #

• 故障仅在非SSR构建场景下触发，SSR构建环境下功能运行完全正常
• 故障触发时机为页面刷新阶段，购物车API请求发起时未携带匹配当前站点的正确币种上下文参数
• 故障表现分两类：
  • 动态站点绑定模式：API请求被自动附加固定USD作为币种参数
  • 静态站点绑定模式：API请求默认取多站点配置列表中的第一个币种值，与当前访问的二级站点实际绑定币种不匹配
• 根因逻辑：页面刷新时，Spartacus 2.0框架在站点上下文未完成解析的阶段，直接从全局默认币种列表取值发起购物车请求

可落地修复方案 #

1. 解决上下文初始化与API请求的竞态问题 #

该问题为Spartacus 2.0非SSR场景下的已知时序缺陷：站点上下文解析逻辑的执行时机晚于购物车模块的API请求发起时机，最终导致参数取值错误。

• 调整根模块的加载顺序，将站点上下文相关服务的初始化逻辑前置到App启动阶段
• 利用Spartacus提供的ContextInitializer扩展点，自定义币种上下文的初始化逻辑，确保应用启动后、路由激活前完成当前站点的币种值解析
• 增加路由前置守卫：在路由加载前校验ContextService中当前币种值是否与当前站点配置匹配，校验通过后再放行路由，避免业务模块在上下文未就绪时发起请求

2. 动态站点绑定场景的拦截器兜底修复 #

针对动态绑定模式下请求默认附加USD参数的问题，通过HTTP拦截器对出站请求做统一参数校验：

• 自定义全局HTTP拦截器，拦截所有业务API请求
• 拦截器内根据当前访问域名匹配对应站点配置，读取绑定的正确币种值
• 替换请求URL中自动附加的默认币种参数值，确保所有请求携带的币种参数与当前站点匹配
  参考实现代码：

@Injectable()
export class CurrencyParamInterceptor implements HttpInterceptor {
  constructor(private contextService: ContextService, private siteConfigService: SiteConfigService) {}

  intercept(req: HttpRequest<unknown>, next: HttpHandler): Observable<HttpEvent<unknown>> {
    // 实时读取当前站点匹配的有效币种值
    const validCurrency = this.contextService.getActiveCurrencySync();
    // 覆写请求中错误的默认币种参数
    const updatedRequest = req.clone({
      params: req.params.set('currency', validCurrency)
    });
    return next.handle(updatedRequest);
  }
}

3. 静态站点绑定场景的取值逻辑修复 #

针对静态绑定模式下刷新时默认取配置列表第一个币种的问题：

• 调整多站点配置的取值优先级，非SSR场景下优先从域名路径映射规则、浏览器本地存储中读取当前站点绑定的币种值，再做全局默认值兜底
• 关闭Spartacus默认的上下文回退逻辑，通过配置将context.fallbackLogicEnabled设置为false，避免系统在上下文匹配失败时自动取配置列表的第一个条目值
• 检查静态路由配置中的站点映射关系，确保每个二级站点域名的配置条目在路由激活时就注入到服务中，而非从全局配置索引读取默认值

4. 版本补丁适配方案 #

该问题在Spartacus 2.0分支后续补丁版本中已被官方修复：

• 优先将现有2.0版本升级到2.0.12及以上的2.0分支最终补丁版本，该版本已解决非SSR场景下上下文初始化与购物车请求的竞态问题
• 若受版本约束无法升级，可在购物车模块的初始化逻辑中增加事件监听：待CurrencySet事件触发、确认币种值正确后，再发起购物车初始化的API请求，避免在币种值未就绪时提前调用接口

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