站外商详的重构与优化

站外商详（H5/小程序）一直以来采用detailV3老接口数据，在样式和功能上，不能与最新版的客户端同步对齐，各个端之间的使用体验之间存在差异。

从唤端数据可以看出来，App商品详情页分享后的唤端成功率非常高，能够达到75%以上，代表着这些用户都是带有明确目标和意愿来App内部进入购买商品，ROI好的高净值用户：

而对于日均pv占据站外流量的TOP3的站外商详来说，唤端价值相对比较高的同时，uni-app多端同构方案的SPA架构限制了H5与小程序页面性能体验天花板，长期以来站外商详的性能指标在前端平台的性能统计大盘下比较靠后：

从上面的性能数据监控并对比源码搭建页面的性能数据可以看出来，旧版的商详性能数据并不理想，对用户在站外商详页的转化率有一定影响：

• 平均fmp：2.75s；

• 75分位平均fmp：2.74s——对比源码搭建大盘1.29s多了1.45s；

• 平均lcp：3.29s；

• 75分位平均lcp：4.06s——对比源码搭建大盘1.46s多了2.6s；

综上背景，我们决定重构站外商详，一方面可以接入得物后台最新版本的商详数据API，便于后续需求迭代，避免站外商详和App商详体验的持续割裂现象；另一方面可以同时提高站外商详的前端性能，带给用户更好的使用体验。

我们本次站外商详升级到创新商详版本，放弃了原项目的uni-app多端同构方案，同时采用营销侧的技术基建——源码搭建；提高了站外秒开性能和用户体验，同时又保证了代码层面的同构开发，本文将详细介绍本次站外商详的重构与优化。

源码搭建是得物前端平台基于SSR架构的C端基建，本次商详重构采用源码搭建来完成重构任务，以下是源码搭建的简要介绍：

源码搭建介绍：

源码搭建是利用页面搭建器现有开发组件能力快速生产页面的开发方式，业务开发不需要关心公用组件、体验、性能和稳定性基础建设，只需要在建立好的页面仓库中开发业务代码即可，集成了流水线构建会自动帮助开发构建上传。

• 本次重构有一个核心诉求：提高前端页面加载性能，而提高秒开体验的核心即SSR：在Node端请求服务端数据并渲染出HTML结构直出给到浏览器；

• 但同时商详数据是电商平台的核心数据，尤其是得物出价相关数据一直都被各种黑产爬虫关注，所以风控侧要求商详接口数据需要做加密处理。

此时就有用户体验 & 数据安全的矛盾存在：

• 数据加密的情况下，Node端无法解密数据，此时便无法直出HTML结构，相当于降级为SPA，用户体验相较于SSR大打折扣；

• 如果数据不加密，Node端可以解析数据做到HTML直出，但是数据安全又无法得到保障。

那么这之间的矛盾和冲突我们是如何解决的呢？

• 将首屏数据（即对用户体验影响最大的fmp、lcp元素渲染涉及到的数据）从完整接口中拆分出来，这一部分数据跟需要加密的敏感数据无关，所以不需要加密处理；

• 拆分出首屏数据接口，然后在SSR阶段只请求首屏数据接口，并渲染HTML结构返回到浏览器；

• 浏览器端运行时（即用户已经在浏览器端打开了页面的时机），再通过风控请求完整的加密数据接口，并渲染到页面；

• 通过拆分首屏接口和分离首屏数据渲染和完整数据渲染，这样就能同时保障首屏渲染速度与风控侧的加密需求。

简要流程如下图所示：

我们重构的主要目的是为了提高性能以及对接最新版服务端接口，但是又不能因为重构而放弃了以往uni-app架构下的多端同构优势，所以需要设计一套新的运行流程来适配SSR下的新商详。

H5环境下我们可以直接访问SSR架构下的新商详，但是小程序运行环境该如何运行呢？

• 小程序的开放组件包含了webview组件，所以我们可以依靠小程序环境中的webview组件来替换原本的小程序原生页面，以下设计图大致描述了我们是如何保障一份代码，如何多环境运行的：

对于pv较高且包含完整交易链路的站外商详来说，冒烟点和阻塞线上购买流程的故障是不可接受的，因此我们设计了相对来说比较完备的止损策略。

新版商详上线后，旧版页面暂时不会下线，路径和代码依旧保持不变；因此可以作为降级页面，能够保障在新版商详出问题后无缝将流量切回旧版商详。

如果SSR侧的请求出现了不可用现象，只会影响简版数据接口的渲染，因此即便失败了也只是影响秒开性能，而不会中断正常业务流程。

结合前端配置中心，我们可以通过逐步灰度放量方式对命中灰度的用户采取跳转新版商详策略，同时灰度配置也可以作为紧急的回滚手段，在遇到故障时及时将灰度放量关闭，引导所有用户跳转旧版商详。

在商详页面的整体重构过程中，我们识别出了一些关键模块需要进行针对性的重构。 这些模块的重构目标是确保它们能够有效地适配商详页面的整体架构变化，同时提升可拓展性。这些针对性重构帮助我们解决了现有迭代中的瓶颈，并在保证系统稳定性的同时，加速开发的迭代过程。

接下来我们详细介绍其中请求拦截器与业务埋点Hook的重构设计。

因为新版商详需要在多种场景（Node.js / 微信小程序 / 移动端浏览器）运行代码，同时可以预见的是后续会有更多场景（如：支付宝小程序等）加入运行环境。

为了保障后续更多运行环境拓展性和可维护性，我们重构了请求拦截器模块：

1、RequestInceptor类型定义：

通过从定义层面区分不同环境，可以有效保障拦截器运行在有效环境，也从逻辑底层避免了一些可以前置避免的类型错误（比如在node环境下访问window等）：

export interface RequestInceptor> {  (): {    // node环境的请求拦截    nodeEnv: (config: T, runtimeConfig?: RunTimeConfig) => Promise | T;    // 浏览器环境的请求拦截    clientEnv: (config: T, runtimeConfig?: Pick) => Promise | T;  };}

2、RequestInceptor的具体实现：

每个RequestInceptor都是一个函数，根据环境返回不同的处理逻辑，示例代码：

const h5CommonHeaders: RequestInceptor = () => ({  // 不同环境下需要携带一些不同的request header  nodeEnv: config => {    config.headers['reqEnv'] = 'node';    return config;  },  clientEnv: async config => {    config.headers['appid_org'] = 'wxapp';    return config;  },});
const yunDunSDK: RequestInceptor = () => ({  nodeEnv: config => config,  clientEnv: async config => {    // 只需要在浏览器环境加载的sdk    await yunDunLoad;    return config;  },});

3、inceptorsLoader和requestInceptorsCreator共同实现了请求拦截器的处理流程：

inceptorsLoader:

const inceptorsLoader = async (initialConfig: InitialConfig, inceptors: RequestInceptor[]) => {  const promiseList = map(inceptors, interceptor => {    return async (config: InitialConfig) => {      const { nodeEnv, clientEnv } = interceptor();        if (isInWindow) {          return clientEnv(config, config?.runTimeConfig);        } else {          return nodeEnv(config, config?.runTimeConfig);        }    };  });  const promiseListResult = await promiseList.reduce(    (promise, fn) =>      promise.then(config => {        return fn(config);      }),    Promise.resolve(initialConfig),  );  return promiseListResult;};

• 这个函数接收两个参数：initialConfig和interceptors；

• initialConfig是初始的请求配置，包含请求方法、URL、参数等；

• interceptors是一个请求拦截器的数组，每个拦截器都是一个对象，包含nodeEnv和clientEnv属性，分别表示在Node环境和浏览器环境下的处理逻辑；

• 使用map函数将interceptors数组转换为处理函数的数组，并按顺序执行这些处理函数；

• reduce方法用于串联这些处理函数，形成一个Promise链。每个处理函数（fn）接收当前的配置（config）作为参数，然后根据环境执行相应的处理（nodeEnv或clientEnv）。

requestInceptorsCreator:

export const requestInceptorsCreator = (config: InitialConfig) =>  inceptorsLoader(config, [    // 通用的headers    h5CommonHeaders,    // 风控    yunDunSDK  ]);

这个函数是一个工厂函数，它接收一个config对象作为参数，用于创建并返回一个处理后的配置对象。

4、通过RequestInceptor的设计，结合工厂函数requestInceptorsCreator，可以灵活地添加、删除或修改请求拦截器，同时保证拦截器按照特定的顺序执行。这种方式使得请求处理逻辑更加模块化、可测试和易于维护。在实际应用中，只需要调用requestInceptorsCreator函数，传入初始配置，即可得到一个完整的、优化过的请求配置，然后可以将其传给HTTP客户端（如axios）来发起请求。

一直以来，埋点开发深受前端同学吐槽和困扰，因为大量的埋点逻辑都跟业务逻辑/视图渲染有着强绑定的关系，同时又不得不写大量的“模版式代码”，费心又费力。

本次重构基于React Hook重构了埋点上报的应用层逻辑，可以在组件内引入Hook进行自定义上报/曝光上报；能更加高效的基于不同平台的运行环境去上报指定的埋点参数。

埋点Hook实现层：

1、generateTrackConfig 函数核心代码：

const generateTrackConfig = (trackSend: Readonly<Array<{ name: string }>>) => {  return function createTrackConfig() {    const names = trackSend.map(item => item.name);
    /**     * 埋点名由三部分组成：     * 例：trackEventName_1234_3210     * event: 'trackEventName'     * current_page: '1234'     * block_type: '3210' 可能不存在     */    // 这里将埋点平台的函数名拆分出具体的上报入参    const extractEventData = (current: string) => {      const nameSplit = current.split('_');      const