Spartacus自定义AuthHttpHeaderService后登录页显示404异常问题

成因 #

自定义AuthHttpHeaderService（哪怕仅继承不修改）破坏了Spartacus默认的请求头与站点信息绑定逻辑：

• 默认的AuthHttpHeaderService内部依赖BaseSiteService的异步方法getActiveBaseSite()，会确保请求发送前已获取到当前活跃站点的UID，并自动填充到OCC请求路径中。
• 当你自定义该服务时，如果没有正确继承父类的所有依赖注入逻辑，或者无意中覆盖了getHeaders()方法的异步等待逻辑，会导致请求在站点信息未就绪时就被发送。
• 退出再登录的场景下，站点信息会被重置，此时basesites请求还未返回，登录跳转触发的CMS页面请求就已发出，路径中缺失站点UID，OCC接口返回Base site cms doesn't exist错误，最终触发404页面。

解决方法 #

• 保持服务继承的完整性：如果不需要修改逻辑，直接取消自定义该服务；若必须自定义，确保完整继承父类的所有依赖，且不要覆盖getHeaders()方法（除非你完全复刻父类的异步等待逻辑）。示例代码：

import { Injectable } from '@angular/core';
import { AuthHttpHeaderService, HttpHeaders, BaseSiteService, OccConfig, AuthService, UserTokenService } from '@spartacus/core';

@Injectable({
  providedIn: 'root',
  useClass: CustomAuthHttpHeaderService,
})
export class CustomAuthHttpHeaderService extends AuthHttpHeaderService {
  constructor(
    protected httpHeaders: HttpHeaders,
    protected baseSiteService: BaseSiteService,
    protected occConfig: OccConfig,
    protected authService: AuthService,
    protected userTokenService: UserTokenService
  ) {
    // 必须调用父类构造函数，传递所有依赖
    super(httpHeaders, baseSiteService, occConfig, authService, userTokenService);
  }
}

• 确保请求等待站点就绪：如果需要自定义getHeaders()，必须在方法中加入等待站点信息的逻辑，比如使用switchMap操作符结合getActiveBaseSite()：

override getHeaders(headers?: HttpHeaders): Observable<HttpHeaders> {
  return this.baseSiteService.getActiveBaseSite().pipe(
    switchMap((baseSite) => {
      // 在这里添加你的自定义逻辑，之后调用父类方法或处理头信息
      return super.getHeaders(headers);
    })
  );
}

• 检查服务注册方式：确保在Angular的提供者中正确替换默认服务，不要破坏Spartacus的依赖注入链。

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