## 核心结论

在 SAP Commerce Cloud Composable Storefront 中，通过 Guest Checkout 形成的购物车，应当使用下面这组标识读取：

```text
userId = anonymous
cartId = guest cart 的 guid
```

对应的 OCC 请求是：

```http
GET /occ/v2/{baseSiteId}/users/anonymous/carts/{cartGuid}?fields=FULL
Authorization: Bearer {client_access_token}
```

这里最容易混淆的是：

* 不使用购物车的 `PK`
* 不使用 Backoffice 中显示的购物车 `code`
* 不使用 guest customer 的 `uid`
* 不使用 guest 输入的电子邮件
* 应当使用购物车的 `guid`

SAP 官方说明，匿名用户调用 OCC API 时，需要使用 OAuth client token，并通过 GUID 标识其购物车；注册用户则通常使用购物车 `code`。([SAP Help Portal][1])

---

# 一、为什么 Backoffice 中的 guest user 不能直接作为 OCC 的 userId

在 Backoffice 中，你可能看到购物车的 `User` 字段类似：

```text
guest [a4e594f7-dba5-4715-9b90-68482bc04279|a@sap.com]
```

这里通常表示：

```text
guest customer uid
=
a4e594f7-dba5-4715-9b90-68482bc04279|a@sap.com
```

在 Guest Checkout 过程中，Commerce 会创建一个临时的 guest customer，并把这个 guest customer 设置为购物车的 `user`。但是，当前 Web 会话的 session user 仍然保持为 `anonymous`。SAP 的 `CustomerFacade` 文档明确说明：

* Guest Checkout 会创建 guest customer；
* guest customer 会成为购物车的用户；
* session user 仍然是 anonymous。([SAP Help Portal][2])

因此，即使数据库中的 `CartModel.user` 已经指向类似下面的 guest customer：

```text
a4e594f7-dba5-4715-9b90-68482bc04279|a@sap.com
```

OCC 调用仍然应当使用：

```text
/users/anonymous/carts/{cartGuid}
```

而不是：

```text
/users/a4e594f7-dba5-4715-9b90-68482bc04279|a@sap.com/carts/{cartCode}
```

---

# 二、在当前 Composable Storefront 会话中读取 guest cart

如果你只是要在当前 Composable Storefront 页面或自定义组件中，读取当前浏览器会话正在使用的 guest cart，推荐使用 `ActiveCartFacade`，而不是自己直接拼接 OCC URL。

SAP 当前的 Composable Storefront API 中，`ActiveCartFacade` 提供了：

```text
getActive()
getActiveCartId()
getEntries()
isStable()
isGuestCart()
reloadActiveCart()
```

等方法。([GitHub][3])

示例：

```typescript
import { Injectable, inject } from '@angular/core';
import {
  ActiveCartFacade,
  Cart,
} from '@spartacus/cart/base/root';
import { Observable } from 'rxjs';

@Injectable({
  providedIn: 'root',
})
export class GuestCartReaderService {
  private readonly activeCartFacade = inject(ActiveCartFacade);

  /**
   * 读取当前 storefront 会话中的 active cart。
   *
   * 对于未登录用户或 guest checkout 用户，
   * Composable Storefront 会在内部使用 anonymous + cart GUID。
   */
  getActiveCart(): Observable<Cart> {
    return this.activeCartFacade.getActive();
  }

  /**
   * 获取当前 active cart 的标识。
   *
   * 对于匿名购物车，这通常对应购物车 GUID。
   */
  getActiveCartId(): Observable<string> {
    return this.activeCartFacade.getActiveCartId();
  }

  /**
   * 判断当前购物车是否属于 guest checkout 场景。
   */
  isGuestCart(): Observable<boolean> {
    return this.activeCartFacade.isGuestCart();
  }

  /**
   * 强制重新从后端加载当前 active cart。
   */
  reload(): void {
    this.activeCartFacade.reloadActiveCart();
  }
}
```

在组件中使用：

```typescript
import { Component, inject } from '@angular/core';
import { AsyncPipe, JsonPipe } from '@angular/common';
import { GuestCartReaderService } from './guest-cart-reader.service';

@Component({
  selector: 'app-guest-cart-debug',
  standalone: true,
  imports: [AsyncPipe, JsonPipe],
  template: `
    <pre>{{ cart$ | async | json }}</pre>
  `,
})
export class GuestCartDebugComponent {
  private readonly guestCartReader = inject(GuestCartReaderService);

  readonly cart$ = this.guestCartReader.getActiveCart();
}
```

这种方式的优点是：

* 不需要自己判断当前用户是 `anonymous` 还是 `current`
* 不需要自己管理 cart GUID
* 不需要手工处理 Store 状态
* 能自动使用 Composable Storefront 已配置的 OCC endpoint
* 能使用标准的 cart normalizer 和 interceptor
* 能跟随语言、货币、站点以及登录状态变化

对于读取当前页面正在操作的 guest cart，这是首选方案。

---

# 三、知道 guest cart GUID 时，使用 CartConnector 读取

如果你已经明确知道某个 guest cart 的 GUID，并且需要在 Composable Storefront 内部显式加载它，可以使用 `CartConnector`。

SAP 的 `CartConnector` 提供：

```typescript
load(userId: string, cartId: string)
```

底层会调用对应的 `CartAdapter`，标准实现通常是 `OccCartAdapter`。([GitHub][4])

示例：

```typescript
import { Injectable, inject } from '@angular/core';
import { CartConnector } from '@spartacus/cart/base/core';
import { Cart } from '@spartacus/cart/base/root';
import { OCC_USER_ID_ANONYMOUS } from '@spartacus/core';
import { Observable } from 'rxjs';

@Injectable({
  providedIn: 'root',
})
export class ExplicitGuestCartReaderService {
  private readonly cartConnector = inject(CartConnector);

  readGuestCart(cartGuid: string): Observable<Cart> {
    if (!cartGuid?.trim()) {
      throw new Error('Guest cart GUID must not be empty.');
    }

    return this.cartConnector.load(
      OCC_USER_ID_ANONYMOUS,
      cartGuid.trim()
    );
  }
}
```

实际语义等同于：

```http
GET /occ/v2/{baseSiteId}/users/anonymous/carts/{cartGuid}
```

不过要注意，`CartConnector.load()` 只是返回该购物车的数据，不会自动把它设置为当前 active cart。

因此：

```typescript
cartConnector.load('anonymous', guid)
```

适合：

* 查看指定购物车
* 调试购物车
* 自定义 cart preview
* 在特定业务服务中读取指定 guest cart

而：

```typescript
activeCartFacade.getActive()
```

适合：

* 读取当前 storefront 正在操作的购物车
* 购物车页面
* checkout 页面
* mini cart
* 自定义 checkout 组件

---

# 四、直接通过 OCC API 读取

在 storefront 外部，例如：

* Node.js 服务
* SAP Integration Suite
* 后台管理程序
* 测试脚本
* Postman
* 客服辅助程序

可以直接调用 OCC。

请求格式：

```http
GET https://{commerce-host}/occ/v2/{baseSiteId}/users/anonymous/carts/{cartGuid}?fields=FULL
Authorization: Bearer {client_access_token}
Accept: application/json
```

SAP 的 OCC 文档规定：

```text
userId:
anonymous = 匿名或 guest checkout 用户
current   = 当前已认证用户

cartId:
匿名或 guest checkout = cart GUID
已登录用户            = cart code
```

([SAP Help Portal][5])

Node.js 或服务器端 TypeScript 示例：

```typescript
export interface GuestCartReadOptions {
  occBaseUrl: string;
  baseSiteId: string;
  cartGuid: string;
  clientAccessToken: string;
}

export async function readGuestCart(
  options: GuestCartReadOptions
): Promise<unknown> {
  const {
    occBaseUrl,
    baseSiteId,
    cartGuid,
    clientAccessToken,
  } = options;

  if (!cartGuid?.trim()) {
    throw new Error('cartGuid is required.');
  }

  if (!clientAccessToken?.trim()) {
    throw new Error('clientAccessToken is required.');
  }

  const baseUrl = occBaseUrl.replace(/\/+$/, '');

  const url = new URL(
    `${baseUrl}/${encodeURIComponent(baseSiteId)}` +
      `/users/anonymous/carts/${encodeURIComponent(cartGuid)}`
  );

  url.searchParams.set('fields', 'FULL');

  const response = await fetch(url, {
    method: 'GET',
    headers: {
      Authorization: `Bearer ${clientAccessToken}`,
      Accept: 'application/json',
    },
  });

  if (!response.ok) {
    const responseText = await response.text();

    throw new Error(
      `Unable to read guest cart. ` +
        `HTTP ${response.status}: ${responseText}`
    );
  }

  return response.json();
}
```

调用示例：

```typescript
const cart = await readGuestCart({
  occBaseUrl: 'https://api.example.com/occ/v2',
  baseSiteId: 'electronics-spa',
  cartGuid: '1a2b3c4d-5678-90ab-cdef-1234567890ab',
  clientAccessToken: process.env.OCC_CLIENT_TOKEN!,
});

console.log(cart);
```

## 安全注意事项

不要在 Angular 浏览器代码中保存：

```text
client_secret
```

如果需要由自定义系统读取任意指定的 guest cart，建议由服务器端服务获取 client token，再由服务器调用 OCC。

Guest cart GUID 也应当被视为敏感标识。根据 SAP 的匿名调用模型，有效的 client token 加上正确的 cart GUID，就构成匿名购物车调用所需的主要身份信息。([SAP Help Portal][1])

---

# 五、能否用已经登录的真实客户读取 guest cart

假设真实客户登录后，当前用户是：

```text
current
```

而你持有一个 guest cart GUID：

```text
a4e594f7-dba5-4715-9b90-68482bc04279
```

不要直接调用：

```http
GET /occ/v2/electronics-spa/users/current/carts/a4e594f7-dba5-4715-9b90-68482bc04279
```

因为这个请求混用了两套身份语义：

```text
current       = 已登录真实客户
guest cart ID = 匿名购物车 GUID
```

`current` 用户通常应当读取自己的 cart code 或当前购物车，而 guest cart GUID 应当放在 `anonymous` 路径下。

如果业务目标只是查看 guest cart，应使用：

```http
GET /users/anonymous/carts/{guestCartGuid}
```

并使用 client token。

如果业务目标是让已经登录的客户接管这个 guest cart，则应使用购物车恢复或合并操作，而不是普通的读取操作：

```http
POST /occ/v2/{baseSiteId}/users/current/carts
    ?oldCartId={guestCartGuid}
    &fields=FULL
Authorization: Bearer {registered_user_access_token}
```

其中：

```text
oldCartId = anonymous cart GUID
```

OCC 会将匿名购物车恢复为当前用户的购物车。如果当前用户已经有购物车，还可能涉及 `toMergeCartGuid` 参数。SAP 官方将这个接口描述为创建新购物车，或者在提供 `oldCartId` 时，将匿名购物车恢复为用户购物车。([SAP Help Portal][6])

例如：

```typescript
async function takeOwnershipOfGuestCart(
  occBaseUrl: string,
  baseSiteId: string,
  guestCartGuid: string,
  userAccessToken: string
): Promise<unknown> {
  const url = new URL(
    `${occBaseUrl.replace(/\/+$/, '')}/` +
      `${encodeURIComponent(baseSiteId)}/users/current/carts`
  );

  url.searchParams.set('oldCartId', guestCartGuid);
  url.searchParams.set('fields', 'FULL');

  const response = await fetch(url, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${userAccessToken}`,
      Accept: 'application/json',
      'Content-Type': 'application/json',
    },
    body: '{}',
  });

  if (!response.ok) {
    throw new Error(
      `Cart restoration failed: HTTP ${response.status} ` +
        `${await response.text()}`
    );
  }

  return response.json();
}
```

这个操作不是只读操作，它会改变购物车所有权或触发购物车合并。标准 Composable Storefront 在匿名用户登录时，通常已经包含 active anonymous cart 的恢复或合并流程，因此不要在正常登录流程之外重复执行。

---

# 六、如何获得正确的 guest cart GUID

从 OCC 返回的购物车数据中，通常会同时看到：

```json
{
  "code": "00012345",
  "guid": "a4e594f7-dba5-4715-9b90-68482bc04279"
}
```

对于 guest cart，后续调用应使用：

```typescript
cart.guid
```

而不是：

```typescript
cart.code
```

在 Composable Storefront 中可以这样取得：

```typescript
this.activeCartFacade
  .getActive()
  .subscribe((cart) => {
    console.log('cart code:', cart.code);
    console.log('cart GUID:', cart.guid);
  });
```

或者：

```typescript
this.activeCartFacade
  .getActiveCartId()
  .subscribe((cartId) => {
    console.log('active cart ID:', cartId);
  });
```

对于匿名购物车，Composable Storefront 的 active cart ID 通常就是用于 OCC 调用的 GUID。

---

# 七、常见错误及其原因

| 调用方式                                 | 结果                             |
| ------------------------------------ | ------------------------------ |
| `/users/anonymous/carts/{cartGuid}`  | 正确的 guest cart 读取方式            |
| `/users/anonymous/carts/{cartCode}`  | 通常找不到，因为匿名购物车需要 GUID           |
| `/users/current/carts/{cartGuid}`    | 用户身份与购物车身份不匹配                  |
| `/users/{guestUid}/carts/{cartCode}` | 不符合标准 guest checkout OCC 调用模型  |
| 使用购物车 `PK`                           | OCC 不使用数据库 PK 查购物车             |
| 使用 customer ID 作为 cartId             | customer ID 不是购物车标识            |
| 使用 guest email 作为 userId             | email 不是这里需要的 OCC userId       |
| 没有 OAuth token                       | 通常返回 `401` 或 `403`             |
| base site 不一致                        | 可能返回 `404 Cart not found`      |
| guest cart 已经被恢复给登录用户                | 原来的匿名读取路径可能不再适用                |
| 订单已经提交                               | 应当读取 order，而不是继续读取 active cart |

---

# 八、订单提交后的区别

如果 Guest Checkout 已经完成下单，那么原购物车已经进入订单流程。此时业务上通常应读取 guest order，而不是继续把它当作 active cart 读取。

SAP OCC 支持通过 order GUID 或 order code 获取特定订单；对于 guest order，通常使用订单 GUID。([SAP Help Portal][7])

因此需要区分：

```text
下单之前：
GET /users/anonymous/carts/{cartGuid}

下单之后：
读取 guest order，并使用 order GUID
```

购物车的 GUID 与订单的 GUID 不应在业务代码中想当然地视为同一个值，应当使用 place order 响应中返回的订单标识。

---

## 最终建议

在你的场景中，可以按照下面的优先级实现：

1. 当前 Composable Storefront 会话中的 guest cart：

```typescript
activeCartFacade.getActive()
```

2. Composable Storefront 中显式读取一个已知 GUID：

```typescript
cartConnector.load(
  OCC_USER_ID_ANONYMOUS,
  guestCartGuid
)
```

3. 外部系统或服务器端代码读取：

```http
GET /occ/v2/{baseSiteId}/users/anonymous/carts/{guestCartGuid}?fields=FULL
```

4. 已登录用户需要接管 guest cart：

```http
POST /occ/v2/{baseSiteId}/users/current/carts
    ?oldCartId={guestCartGuid}
```

最关键的一点是：

```text
Backoffice 中的 guest customer uid
不等于
OCC URL 中的 userId
```

即使购物车的 `user` 已经显示为：

```text
guest [UUID|email]
```

标准 Guest Checkout 的 OCC 读取仍然是：

```text
anonymous + cart GUID
```

[1]: https://help.sap.com/docs/SAP_COMMERCE_CLOUD_PUBLIC_CLOUD/8684f95315e24f52a22f3d9d16ef3af3/69fd037d06e34149863667df79d8ce8e.html?utm_source=chatgpt.com "OCC API Calls for Anonymous Users"
[2]: https://help.sap.com/doc/9fef7037b3304324b8891e84f19f2bf3/2211/en-US/de/hybris/platform/commercefacades/customer/CustomerFacade.html?utm_source=chatgpt.com "CustomerFacade (hybris Commerce Suite 2211)"
[3]: https://raw.githubusercontent.com/SAP/spartacus/develop/feature-libs/cart/base/root/facade/active-cart.facade.ts "raw.githubusercontent.com"
[4]: https://raw.githubusercontent.com/SAP/spartacus/develop/feature-libs/cart/base/core/connectors/cart/cart.connector.ts "raw.githubusercontent.com"
[5]: https://help.sap.com/doc/a900d1bacb5040a2b2ff0c12556e474d/2007/en-US/index_OCC.html?utm_source=chatgpt.com "Commerce Webservices"
[6]: https://help.sap.com/doc/605a000d462f4b6f89bcbcfb4868b35a/1905/en-US/index.html?utm_source=chatgpt.com "Commerce Webservices v2 with Occ Addons"
[7]: https://help.sap.com/doc/545981ff70a4482ea002cddba3512611/2102/en-US/index.html?utm_source=chatgpt.com "Commerce Webservices"


在 SAP Commerce Cloud Composable Storefront 中，通过 Guest Checkout 形成的购物车，应当使用下面这组标识读取：

如何使用代码读取 guest cart？

紫薇堂堂主

后端

编程语言

开发工具

在SAP Commerce Cloud中，匿名用户购物车应使用OCC API的`/users/anonymous/carts/{cartGuid}`路径读取，而非购物车code或guest用户ID。正确调用需配合OAuth client token，确保数据安全访问。

代码解释

TypeScript

数据库

服务器

GitHub

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

如何使用代码读取 guest cart？-腾讯云开发者社区-腾讯云

如何使用代码读取 guest cart？

如何使用代码读取 guest cart？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐