SAP Spartacus 2211：如何有效重写OccCartAdapter扩展addEmail参数

1. 修正依赖注入的覆盖逻辑 #

在Spartacus 4.x（对应2211版本）中，OccCartAdapter是以root级别注册的，直接在AppModule的providers中覆盖CartAdapter可能因模块加载顺序问题失效。以下是两种可靠的覆盖方式：

方案一：移除自定义适配器的providedIn: 'root'并明确覆盖 #

修改CustomOccCartAdapter的装饰器，去掉providedIn: 'root'，避免默认注册干扰：

@Injectable() // 删除providedIn: 'root'
export class CustomOccCartAdapter extends OccCartAdapter {
  // ... 原有代码
}

然后在AppModule的providers中明确覆盖CartAdapter，确保Spartacus核心模块先导入：

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { CartAdapter } from '@spartacus/cart/base/root';
import { CustomOccCartAdapter } from './path-to-your/custom-occ-cart-adapter';
// ... 其他导入

@NgModule({
  imports: [
    BrowserModule,
    // 先导入Spartacus相关模块
    SpartacusModule,
  ],
  providers: [
    {
      provide: CartAdapter,
      useClass: CustomOccCartAdapter
    },
    // ... 其他提供者
  ],
  bootstrap: [AppComponent]
})
export class AppModule { }

方案二：使用Spartacus配置扩展机制 #

通过Spartacus的provideDefaultConfig指定适配器实现，更符合框架扩展规范：

import { provideDefaultConfig } from '@spartacus/core';
import { CartAdapter } from '@spartacus/cart/base/root';
import { CustomOccCartAdapter } from './path-to-your/custom-occ-cart-adapter';

@NgModule({
  imports: [
    // ... 其他模块
  ],
  providers: [
    provideDefaultConfig({
      backend: {
        occ: {
          adapters: {
            cart: {
              adapter: CustomOccCartAdapter
            }
          }
        }
      }
    }),
    // ... 其他提供者
  ]
})
export class AppModule { }

2. 修复addEmail方法的HttpParams错误 #

HttpParams是不可变对象，调用set方法不会修改原实例，必须重新赋值才能生效：

override addEmail(userId: string, cartId: string, email: string): Observable<{}> {
  let headers = new HttpHeaders({
    'Content-Type': 'application/x-www-form-urlencoded',
  });
  headers = InterceptorUtil.createHeader(USE_CLIENT_TOKEN, true, headers);

  const customerData = this.customLoginStateService.getData();

  // 修正HttpParams赋值方式
  let httpParams = new HttpParams()
    .set('email', email)
    .set('name', customerData.name)
    .set('phone', customerData.phone);

  const url = this.occEndpointsService.buildUrl('addEmail', {
    urlParams: {
      userId,
      cartId,
    },
  });

  return this.http.put(url, httpParams, { headers });
}

3. 验证组件替换有效性 #

确保CustomCheckoutLoginComponent已正确替换原生组件，需在Spartacus配置中声明：

provideDefaultConfig({
  cmsComponents: {
    CheckoutLoginComponent: {
      component: CustomCheckoutLoginComponent
    }
  }
})

额外检查项 #

• 确认CustomLoginStateService是单例服务（使用providedIn: 'root'），保证适配器能正确读取参数。
• 清空浏览器缓存并重启开发服务器，避免旧编译代码干扰。

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