SuperAPI AI 工具集

sfnext-hybrid-storefronts

前端与建站

查看项目

更新于 10-16 05:45

技能介绍

用途:在保留现有 SFRA/SiteGenesis 店面的同时运行 Storefront Next,按页面逐步迁移,避免整体重写。

主要能力:生产环境由 Cloudflare eCDN 按 URL 规则在 Storefront Next(MRT)与 SFRA(B2C 实例)之间路由;本地开发由 @salesforce/storefront-next-dev 的 Vite 插件 hybridProxyPlugin 代理未匹配请求至 SFCC 沙箱,模拟分流。客户端 legacy-routes 中间件拦截指向 SFRA 路由的 <Link> 点击,强制整页跳转。会话桥接通过共享 cookie(dwsid、cc-*)保持登录与购物车状态;SFRA 到 Storefront Next 时用桥接令牌换取 SLAS 令牌,反向则依赖共享 dwsid。

配置:混合模式完全通过环境变量配置,无扩展目录。所有环境需 PUBLIC__app__hybrid__enabled=true 和 PUBLIC__app__hybrid__legacyRoutes(SFRA 拥有的路由)。本地开发另需 HYBRID_PROXY_ENABLED=true、SFCC_ORIGIN、HYBRID_ROUTING_RULES(Cloudflare 表达式,匹配者归 Storefront Next)、可选 HYBRID_PROXY_LOCALE。注意 ^/resource.* 与 ^/action/.* 必须始终路由到 Storefront Next,且路由规则与 legacyRoutes 需互补同步。

适用场景:从 SFRA 渐进迁移,例如先迁首页、商品、分类页,再到账户与搜索,最后购物车结账。

限制与注意:两店面须共享 cookie 域;随页面迁移需更新 eCDN 源规则;需维持 URL 结构以保 SEO;常见问题包括会话丢失(cookie 域不匹配)、购物车不同步、重定向循环、本地 SFRA 页面 404 等。