调用Store API获取购物车时的异常现象及原因咨询

问题描述 #

我通过Store API调用/checkout/cart路由获取客户购物车，请求时传入SalesChannel访问令牌和店铺访客的sw-context-token，但遇到两个异常情况：

• 部分数据库中已存在的sw-context-token，请求后返回带新token的新购物车
• 部分带_backup后缀的token能正常获取购物车，但对应的无后缀token（关联更新后的购物车）无法获取

请求代码如下：

$client = new Client();
$response = $client->request('GET', $shopware->url . '/store-api/checkout/cart', [
    'headers' => [
        'Accept' => 'application/json',
        'sw-access-key' => 'SWSSXXXXXXXXXXXXXX',
        'sw-context-token' => $contextKey
    ],
]);

return json_decode($response->getBody()->getContents(), true);

异常原因分析 #

1. 旧token返回新购物车的原因 #

• token过期失效：Shopware的sw-context-token有默认有效期（由session_lifetime配置控制），如果token已过期，系统会自动生成新token并创建空购物车。
• 上下文不匹配：token关联的上下文（销售渠道、语言、货币等）与当前请求的sw-access-key对应销售渠道配置不一致，系统会拒绝使用旧token，生成新的上下文。
• 数据库数据损坏：sw-context-token对应的购物车或客户关联数据在数据库中被删除、损坏，系统无法找到对应购物车，只能创建新的。

2. 带_backup后缀token可用，无后缀token不可用的原因 #

• 购物车自动备份机制：Shopware在客户登录合并购物车、购物车异常恢复等场景下，会自动生成带_backup后缀的token，备份原购物车数据。
• 无后缀token已被标记无效：原无后缀token对应的购物车可能已被系统清理（比如过期自动清理、合并后标记为废弃），或关联的上下文数据已删除，导致无法查询；而备份token未被清理，仍保留有效数据。
• 手动修改token导致不匹配：如果手动去掉过token的_backup后缀，系统无法找到对应上下文记录，自然无法返回购物车。

解决提示 #

• 检查token有效期：核对Shopware配置中的session_lifetime参数，确认请求的token未过期。
• 验证上下文一致性：确保sw-context-token关联的销售渠道、语言、货币与当前sw-access-key对应的销售渠道配置完全匹配。
• 排查数据库记录：查看cart、customer、context表中，对应token的记录是否存在、是否完整；检查关联数据的状态是否正常。
• 不要手动修改token：若需要恢复备份购物车，直接使用带_backup的token发起请求，或调用官方购物车合并接口处理。
• 开启API日志排查：启用Shopware的API日志功能，查看请求时的具体错误信息（比如上下文验证失败、购物车不存在的详细原因）。

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