Spartacus 4.3与SAP Commerce 2205结账异常：地址页面请求不匹配

问题根源 #

Spartacus 4.3与SAP Commerce 2205存在版本兼容性不匹配：开箱即用状态下，两者结账页面的路由命名规则不一致——Spartacus 4.3沿用旧命名shipping-address，而Commerce 2205已切换为delivery-address，导致前端请求的页面后端不存在，触发循环跳转。

解决方案 #

方案一：版本对齐（推荐）

Spartacus 4.3官方兼容的SAP Commerce版本为2105，将Commerce从2205降级到2105，即可直接恢复开箱即用的结账流程匹配，无需额外代码或配置修改。

方案二：修改Spartacus配置适配Commerce 2205（不推荐，破坏开箱即用特性）

通过调整Spartacus的结账步骤配置，将前端请求的页面标签改为delivery-address，匹配后端页面：

import { CheckoutConfig } from '@spartacus/checkout/base/root';
import { provideConfig } from '@spartacus/core';

// 自定义结账配置，覆盖默认的shippingAddress步骤路由
export const customCheckoutConfig: CheckoutConfig = {
  checkout: {
    steps: [
      {
        id: 'shippingAddress',
        name: 'checkoutProgress.shippingAddress',
        routeName: 'checkoutDeliveryAddress', // 对应后端delivery-address页面
        type: 'shippingAddress',
      },
      // 保留其他默认结账步骤
    ],
  },
};

// 在app.module.ts的providers数组中注入该配置
providers: [
  provideConfig(customCheckoutConfig),
];

修改后需确保Commerce后台的delivery-address页面已正确关联结账地址步骤的开箱即用组件，避免页面为空。

注意：若此前已将后端页面标签改为shipping-address仍无效，是因为Commerce 2205的结账逻辑已深度依赖delivery-address命名，强行修改会导致页面组件关联失效，因此版本对齐是更稳妥的方案。

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