Spartacus SAP 最近浏览产品功能开箱支持情况及实现方案咨询

首先给出核心结论：Spartacus 官方核心库没有提供开箱即用的 最近浏览产品（recently viewed products） 服务或组件，需要通过自定义逻辑实现。

推荐最佳实现方案 #

基于Spartacus原生能力的轻量实现方案如下：

• 自定义根级单例服务 RecentlyViewedService，依赖Spartacus原生提供的RoutingService、ProductService、StorageSyncService三个基础服务
• 在服务内部订阅全局路由变化事件，判断当前路由是否匹配product/:productCode规则，匹配成功后调用ProductService拉取当前产品的必要展示字段（主图、名称、价格、跳转链接即可）
• 对浏览记录列表做去重、排序、长度限制处理：同一个产品重复访问时直接将其移动到列表头部，列表长度超过预设阈值（通常设为10~20条）时自动淘汰最早的浏览记录
• 通过StorageSyncService将处理后的列表同步存储到localStorage，若需要支持跨设备同步，可以额外加逻辑把记录同步到对应用户的后端账户中
• 开发RecentlyViewedComponent展示组件，注入上面的单例服务获取浏览记录列表，通过Spartacus的CMS插槽机制直接挂载到需要展示的位置（产品详情页侧边栏、首页底部等），无需修改现有产品模板的核心代码

不同思路的优劣对比 #

• 你提到的「在产品详情组件中推送数据到服务」的方案不推荐：如果后续存在快速预览弹窗、商品卡片跳转等不经过标准产品详情页的商品访问入口，会出现浏览记录漏采的问题，维护成本更高
• 「用路由守卫/拦截器记录访问」的方案逻辑上可行，但不符合单一职责原则：路由守卫的核心作用是路由权限控制，将浏览行为埋点逻辑放入会导致代码耦合度上升，后续修改规则的成本更高

需要规避的常见问题 #

• 不要手动操作localStorage：使用Spartacus原生的StorageSyncService，它自动处理了序列化、SSR兼容、存储作用域隔离的问题，手动写localStorage操作逻辑很容易在服务端渲染场景下触发报错
• 不要存储全量产品数据：仅保存展示所需的少量字段，避免存储体积过大，同时组件渲染时可以主动校验产品状态，同步拉取最新的价格、库存信息
• 不要忽略数据合规要求：如果面向欧盟等有数据合规要求的区域，需要把最近浏览记录的存储逻辑纳入用户Cookie同意范围，未获得用户授权时不能写入本地存储

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