Shopware 6 API购物车错误处理：清除、确认及相关疑问

1. 如何清除promotion-not-eligible购物车错误消息？ #

当添加不符合条件的优惠券触发该错误后，可通过两种方式处理：

• 后端API层面：调用POST /store-api/cart/refresh接口刷新购物车，该接口会重新校验所有促销规则并清理无效错误状态；部分版本支持在执行购物车操作时携带refreshErrors参数，强制重置错误集合。
• 前端处理层面：在useCart钩子的回调中，监听购物车更新事件，手动移除promotion-not-eligible错误键。比如在购物车更新后直接修改cart.errors对象删除对应键，或在用户执行关闭错误提示、修改配送地址等操作时，主动触发错误清理逻辑。

2. 自定义错误状态方案的优化建议 #

若担心自定义状态导致重复错误无法显示，可采用更灵活的方案：

• 错误键生命周期绑定：维护已显示错误的记录集合，但不设永久标记，而是绑定到特定购物车状态。比如用户修改了触发错误的条件（如更换符合优惠券要求的配送国家），则清空对应错误的已显示标记；再次添加同一无效优惠券时，重新触发错误显示。
• 利用内置通知区分逻辑：Shopware购物车错误对象中，消息键前缀隐含类型（如promotion-not-eligible是错误，promotion-discount-added是成功），前端可过滤出真正的错误类型，结合操作上下文判断是否显示。比如每次购物车更新后对比新旧错误列表，只显示新增错误；当用户重复添加无效优惠券时，只要操作独立就重新提示。
• 错误与操作绑定：将错误和触发它的操作关联，比如添加优惠券触发的错误，仅在下次执行添加优惠券操作时重置，其他操作不影响其显示状态，确保重复操作能再次触发提示。

3. 为什么成功消息会出现在购物车错误对象中？ #

这是Shopware早期响应结构的设计遗留：购物车接口会把所有通知类消息（包括成功提示、错误警告）统一放在errors字段下，而非单独拆分出success或notifications字段。
比如promotion-discount-added-xxx这类键对应的是成功添加促销码的提示，并非真正的错误。可通过消息键前缀或解析错误对象的level属性（部分版本返回，值为success/error/warning）区分通知类型，前端渲染时分类展示，而非将errors字段内容全当作错误处理。

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