罗罗编程学习记录
本页内容 展开查看

07.2.5.5 存量项目迁移路径与风险

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.5 跨端方案对照与选型

本节要解决的问题

  • 存量原生 App 迁移到跨端,有哪三条路径,风险与适用条件分别是什么?
  • 模块边界怎么划分,哪些页面先迁、哪些后迁?
  • 双跑与灰度在迁移中怎么落地,状态与路由割裂怎么处理?
  • 原生能力如何在迁移期复用,桥接与双实现的取舍?
  • 存量跨端项目换框架(RN → Flutter、uni-app → Taro)时,渐进替换与重写怎么选?
  • 组件、API、样式、埋点、监控的迁移映射表怎么建?
  • 迁移中的性能回归、包体膨胀、学习曲线三类风险怎么防控?
  • 人力与排期怎么按页面复杂度分级估算?
  • 失败案例有哪些典型模式,什么情况下根本不该迁?

版本前提:本页所有路径与机制为范式级判断,不绑定具体框架版本号;各框架嵌入方式、动态化能力、鸿蒙适配状态以官方最新文档为准,凡涉及具体能力处标注「待确认」与验证点。框架内部原理见 07.2.1 Flutter 与 Dart、07.2.2 React Native、07.2.3 Kotlin Multiplatform、07.2.4 uni-app。

覆盖范围

知识域 关键内容
原生→跨端路径 重写、页面级渐进迁移、混合嵌入共存,风险与适用条件
模块与页面 模块边界、先迁/后迁顺序、状态与路由割裂、原生能力复用
跨端→跨端换框架 渐进替换 vs 重写、组件 API 映射、样式迁移、埋点监控迁移
风险防控 性能回归、包体膨胀、学习曲线、双栈长期并存
排期估算 按页面复杂度分级、人力模型、里程碑与退出条件
失败复盘 低估原生依赖、低估适配成本、双栈无人收敛

题号索引

题号区间 主题
001-003 三条迁移路径、模块边界、先迁页面选择
004-006 双跑灰度、状态路由割裂、原生能力复用
007-010 跨端换框架:渐进 vs 重写、API 映射、样式、埋点监控
011-013 性能回归、包体膨胀、学习曲线与排期
014-015 失败案例模式、不该迁的判定门槛
016 综合题:复盘一次迁移失败并给出修正路径

07.2.5.5-001 存量原生 App 迁移跨端有哪三条路径?

一句话结论

三条路径:全新重写(整个 App 替换为跨端)、页面级渐进迁移(逐页替换,新旧并存)、混合嵌入共存(原生壳 + 跨端模块长期共存,不追求全部替换);按业务风险与迁移目标选择,渐进迁移是默认推荐路径。

概念解释

机制上,三条路径的核心差异是"新旧代码并存时间"与"业务风险暴露窗口"。全新重写并存时间为零但风险最高:重写期间业务无法迭代,且新框架的坑在全量替换后才暴露。渐进迁移并存时间中等:每次只迁一个页面,可灰度可回退,但双栈维护成本随时间累积。混合嵌入并存时间最长:只把适合跨端的模块迁过去,核心链路永远原生,不追求"全部跨端"。

选择机制:如果业务还在快速迭代、不能停,选渐进迁移;如果目标就是长期混合架构(如电商主 App),选混合嵌入;如果业务已稳定、有充足预算与时间、且跨端是长期战略,才考虑重写。

原理流程

路径 A:全新重写
  旧 App 停止迭代 → 新 App 开发 → 全量切换
  风险:高 / 并存:无 / 业务窗口:长

路径 B:页面级渐进迁移
  旧 App 继续维护 → 逐页替换为跨端 → 旧页面逐步下线
  风险:中 / 并存:中 / 业务窗口:短

路径 C:混合嵌入共存
  原生壳长期存在 → 跨端模块按需要嵌入 → 不追求全替换
  风险:低 / 并存:长 / 业务窗口:无

代码或图示

路径 风险 并存时间 适用条件
全新重写 高 无(重写期间停迭代) 业务稳定、预算充足、跨端是长期战略
页面级渐进 中 中 业务在迭代、可接受双栈短期并存
混合嵌入 低 长 主 App 长期保留原生,跨端只做局部

常见误区

  • 误区:迁移就是要"全部跨端";正解:混合嵌入是常态,主 App 不需要 100% 跨端,部分模块永远原生更合理。
  • 误区:重写一次到位最干净;正解:重写期间业务无法迭代,且新框架的坑在全量替换后才暴露,风险远大于渐进迁移。

追问

  • Q:渐进迁移为什么是默认推荐? A:每次只动一个页面,可灰度、可回退、可积累经验,业务不中断。
  • Q:混合嵌入与渐进迁移的边界在哪? A:渐进迁移有"旧页面全部下线"的终点,混合嵌入没有,核心模块永远原生。

07.2.5.5-002 迁移时模块边界怎么划分?哪些先迁?

一句话结论

先迁"独立、低风险、列表/表单类、性能不敏感"的页面作为试点;后迁"核心交易、深度原生、长列表、高帧率"的页面;边界按"路由独立性、状态归属、原生能力依赖"三个维度划。

概念解释

先迁试点页的机制是:用最低风险验证迁移链路(路由、桥接、状态、埋点、监控)是否通。试点页必须满足:路由独立(不依赖其他原生页面)、状态独立(不与全局状态强耦合)、原生能力依赖少(不依赖深度 SDK)、性能不敏感(列表/表单/设置类)。

后迁页面的机制是:等迁移链路成熟、团队熟悉、指标稳定后,再啃硬骨头。核心交易页面(登录、支付、结算)最后迁,且迁移期间保留原生版本作为灰度兜底。

原理流程

页面清单分类
  ├─ 第一梯队(试点):独立路由、状态独立、能力依赖少、性能不敏感
  ├─ 第二梯队(推广):常见列表、内容页、个人中心
  ├─ 第三梯队(攻坚):核心交易、长列表、音视频
  └─ 不迁(保留原生):启动、登录主链路、支付、生物识别

代码或图示

梯队 页面类型 迁移目标
第一梯队 设置、关于、意见反馈、简单表单 验证链路、积累经验
第二梯队 列表页、内容页、个人中心 扩大跨端覆盖
第三梯队 商品详情、购物车、订单 攻坚,灰度兜底
不迁 启动、支付、生物识别 永远原生

常见误区

  • 误区:先迁最难的核心页面"啃硬骨头";正解:核心页面出问题无法回退,应先迁简单页面验证链路。
  • 误区:所有页面都要迁;正解:启动、支付、生物识别等核心链路永远原生,混合架构本来就允许。

追问

  • Q:试点页怎么选? A:找一个用户量中等、可灰度、出问题影响小的页面,既验证链路又不影响主业务。
  • Q:迁移期旧页面怎么处理? A:旧页面保留原生实现,新页面用跨端实现,通过路由开关灰度切换,详见 07.2.5.6 验收、灰度与回退预案。

07.2.5.5-003 页面级迁移的标准步骤是什么?

一句话结论

页面级迁移分七步:梳理旧页面依赖、搭建跨端容器与桥接、实现新页面、双跑对比、灰度切换、旧页面观察、下线旧页面;每步都有独立验证与回退手段。

概念解释

机制上,每一步都要"可验证、可回退":梳理依赖是为了知道新页面需要哪些原生能力;搭建容器与桥接是为跨端页面提供运行环境;实现新页面是业务重写;双跑对比是新旧页面同口径对比;灰度切换是按用户比例放量;旧页面观察是确认新页面稳定;下线旧页面是清理代码。

关键风险点:双跑对比阶段如果不做同口径对比,性能回归就会被漏掉;灰度切换阶段如果不保留旧页面开关,就无法回退。

原理流程

1. 梳理旧页面:路由、状态、原生能力、埋点
2. 搭建跨端容器:引擎初始化、桥接通道、路由协议
3. 实现新页面:业务逻辑、UI、原生能力桥接
4. 双跑对比:同机型同路径同数据,对比性能与功能
5. 灰度切换:按用户比例/机型/渠道放量
6. 旧页面观察:崩溃率、白屏率、性能指标
7. 下线旧页面:移除旧代码与桥接

代码或图示

步骤 产出 验证
梳理依赖 依赖清单 无遗漏
搭建容器 可运行跨端页面 空页面可加载
实现新页面 功能完整 功能回归通过
双跑对比 同口径对比报告 指标不劣于旧版
灰度切换 灰度开关 指标稳定
旧页面观察 监控数据 无异常
下线旧页面 代码清理 无残留依赖

常见误区

  • 误区:迁移时同时改业务逻辑;正解:迁移阶段只做"翻译",业务逻辑变更另开迭代,否则问题无法归因。
  • 误区:双跑对比只看功能;正解:性能、稳定性、埋点数据都要同口径对比,详见 07.2.5.6 验收、灰度与回退预案。

追问

  • Q:跨端容器怎么复用? A:按策略初始化与复用,避免每个页面都新建引擎实例,容器生命周期由原生壳统一管理。
  • Q:迁移期双跑要不要做 AB? A:要,新旧页面各分一部分流量,同口径对比指标,避免"凭感觉"判断。

07.2.5.5-004 迁移期双跑与灰度怎么落地?

一句话结论

双跑是"新旧两套实现同时存在,通过路由开关决定走哪套";灰度是"按用户比例/机型/渠道逐步放量";两者结合是迁移期的标准做法,核心是"任何时候都能切回旧版"。

概念解释

机制上,双跑的关键是路由协议统一:原生壳收到一个路由请求时,根据配置决定走原生页面还是跨端页面。灰度的关键是配置下发:服务端或本地配置决定哪些用户走新页面,配置可实时调整。

双跑的风险是"状态割裂":用户从原生页跳到跨端页,登录态、用户信息、全局状态必须共享;跨端页跳回原生页,页面栈与返回手势必须一致。

原理流程

路由请求到达
  ↓ 查灰度配置
  ├─ 走旧版 → 打开原生页面
  └─ 走新版 → 打开跨端容器,加载新页面
  ↓ 共享状态
  ├─ 登录态:通过桥接共享
  ├─ 用户信息:通过桥接共享
  └─ 页面栈:原生壳统一管理
  ↓ 出问题
  配置切回旧版 → 所有用户回到原生页面

代码或图示

灰度维度 典型比例 用途
内部用户 100% 第一阶段验证
小流量外部 1% - 5% 第二阶段观察
按机型 中端机优先 低端机最后
按渠道 单一渠道先 控制影响面
全量 100% 稳定后放量

路由协议伪代码示意:

onRouteRequest(route) {
  config = loadGrayConfig()
  if (config.isNewVersion(route)) {
    openCrossContainer(route.url)   // 跨端容器
  } else {
    openNativePage(route)           // 原生页面
  }
}

常见误区

  • 误区:双跑就是两套代码都上线;正解:双跑是通过路由开关切换,用户只看到一套,另一套在后台待命。
  • 误区:灰度期间出问题就全量回滚;正解:先按维度收量(如先关低端机、先关某渠道),再决定是否全量回退。

追问

  • Q:灰度配置怎么下发? A:服务端配置中心,App 启动时拉取,支持热更新开关(注意合规与政策约束)。
  • Q:双跑期间用户数据怎么处理? A:数据格式必须向后兼容,回退后旧版能识别新版写入的数据,详见 07.2.5.6 验收、灰度与回退预案。

07.2.5.5-005 迁移期状态与路由割裂怎么处理?

一句话结论

状态割裂靠"统一状态源 + 桥接同步"解决:登录态、用户信息、全局配置由原生壳持有,跨端通过桥接读取;路由割裂靠"原生壳统一管理页面栈"解决:跨端页面只是原生栈中的一个节点,返回手势与页面栈行为一致。

概念解释

机制上,状态割裂的根源是"两套运行时各有各的状态"。解决原则是:单一状态源(Single Source of Truth)放在原生壳,跨端只读不写,或通过桥接写回原生。登录态、用户 token、购物车信息、全局配置都必须走这个原则。

路由割裂的根源是"跨端容器有自己的导航栈"。解决原则是:跨端容器不做导航,只渲染内容,页面栈由原生壳管理。跨端页内的跳转通过桥接通知原生壳,由原生壳决定打开原生页还是跨端页。

原理流程

状态共享
  原生壳持有:登录态 / 用户信息 / 全局配置
  跨端通过桥接:读取(同步)→ 使用
  跨端需要写:通过桥接 → 原生壳更新 → 同步回跨端

路由共享
  原生壳管理页面栈
  跨端页内跳转 → 桥接通知原生壳 → 原生壳 push/pop
  返回手势 → 原生壳处理 → 跨端容器随栈弹出

代码或图示

状态类型 归属 跨端访问方式
登录态/token 原生壳 桥接同步读取
用户信息 原生壳 桥接读取,变更通知
全局配置 原生壳 桥接读取
页面局部状态 跨端容器 容器内自管理
购物车/订单 原生壳或服务端 桥接 + 接口

常见误区

  • 误区:跨端自己存一份登录态;正解:双端各存一份必然不一致,统一由原生壳持有。
  • 误区:跨端容器自己做导航栈;正解:跨端容器的导航栈与原生栈不一致,返回手势与页面转场会出问题。

追问

  • Q:跨端页内的子页面怎么处理? A:子页面仍在跨端容器内,由跨端路由管理,但跨端容器本身在原生栈中是一个节点。
  • Q:状态同步延迟怎么办? A:关键状态(登录态、用户信息)在跨端页启动时一次性拉取,运行中通过桥接事件通知变更。

07.2.5.5-006 迁移期原生能力如何复用?

一句话结论

原生能力复用有三条路径:现成桥接封装(优先)、自研桥接(中等成本)、双实现(最昂贵但最灵活);原则是"能桥接不自研,能自研不双实现",且桥接层要隔离,避免业务直接依赖原生实现。

概念解释

机制上,迁移期原生能力往往已经有原生实现(如支付、推送、生物识别、相机、蓝牙)。跨端页面需要这些能力时,不应该重新用跨端框架实现一遍,而是通过桥接调用原生已有实现。

三条路径的成本:现成桥接封装最低(社区库或团队已有),自研桥接中等(写桥接层 + 双端实现),双实现最昂贵(跨端自己写一套原生能力,不依赖原生壳)。双实现只在跨端模块需要独立于原生壳运行时才考虑(如未来可能独立成 App)。

桥接层的设计原则是"业务不感知":业务代码只调用统一接口(如 PaymentService.pay(order)),不直接接触桥接细节。这样未来换框架或调整原生实现时,业务代码不需要改。桥接层本身要独立封装,有完整的类型契约与错误处理。

原理流程

跨端页面需要原生能力
  ↓ 查现成桥接
  ├─ 有现成 → 直接用
  ├─ 无现成 → 评估自研桥接
  │    ├─ 能力简单 → 自研桥接
  │    └─ 能力复杂 → 评估双实现或保留原生页面
  └─ 跨端需要独立运行 → 双实现

代码或图示

能力类型 复用方式 成本
支付/推送/生物识别 现成桥接或原生已有实现 低
相机/相册/定位 现成桥接库 低
蓝牙/外设/传感器 自研桥接 中
深度音视频/自定义渲染 自研桥接或原生嵌入 高

常见误区

  • 误区:跨端页面重新实现一遍原生能力;正解:迁移期原生能力已经有实现,桥接调用即可,不要重复造轮子。
  • 误区:桥接层写在业务代码里;正解:桥接层要独立封装,业务代码只调用统一接口,未来换框架时桥接层可替换。

追问

  • Q:桥接层怎么设计? A:定义统一接口(如 PaymentService.pay(order)),原生实现一套,跨端调用同一接口,未来换框架时只改跨端侧调用。
  • Q:什么情况下必须双实现? A:跨端模块需要独立于原生壳运行(如未来可能拆成独立 App、或嵌入到其他宿主 App),此时跨端必须自带能力实现。

07.2.5.5-007 存量跨端项目换框架:渐进替换 vs 重写怎么选?

一句话结论

跨端换框架(如 RN → Flutter、uni-app → Taro)默认选渐进替换:按页面逐个迁移,旧框架继续维护新需求直到全部迁完;重写只在"旧框架已停止维护、团队已无法忍受、且业务有足够窗口"时才考虑。

概念解释

机制上,跨端换框架的风险比原生→跨端低,因为都是"一套代码多端跑",业务逻辑可以大量复用。但风险仍在于:组件库、API、样式、导航、状态管理、埋点都要重新对齐。

渐进替换的机制是:新框架搭好壳,逐页把旧页面"翻译"到新框架,旧框架继续承接新需求直到全部迁完。重写的机制是:新框架从零写整个 App,旧框架停止迭代,全量切换。

选择机制:如果旧框架还能维护、业务在迭代,选渐进替换;如果旧框架已停止维护、关键版本已不支持、且业务有 3-6 个月窗口,才考虑重写。

原理流程

跨端换框架决策
  ├─ 旧框架还能维护 → 渐进替换
  │    ├─ 新框架搭壳
  │    ├─ 逐页迁移
  │    └─ 旧框架承接新需求直到全部迁完
  └─ 旧框架停更/无法维护 + 业务有窗口 → 重写
       ├─ 新框架从零写
       ├─ 旧框架停止迭代
       └─ 全量切换

代码或图示

方案 风险 业务窗口 适用条件
渐进替换 中 无中断 旧框架可维护、业务在迭代
重写 高 3-6 个月 旧框架停更、业务有窗口

常见误区

  • 误区:换框架就重写;正解:渐进替换可以业务不中断,风险远小于重写。
  • 误区:换框架时业务逻辑可以直接复用;正解:业务逻辑(网络、状态、数据处理)可以大量复用,但 UI、组件、导航、样式必须重写。

追问

  • Q:渐进替换期间旧框架还接新需求吗? A:接,但新需求优先在新框架开发,旧框架只维护已迁移页面的缺陷,避免双栈膨胀。
  • Q:重写的最大风险是什么? A:重写期间业务无法迭代,且新框架的坑在全量上线后才暴露,业务可能等不及。

07.2.5.5-008 组件与 API 差异映射表怎么建?

一句话结论

映射表分四层:基础组件(View/Text/Image)、交互组件(Button/Input/ScrollView)、导航与路由、状态管理与网络;每个旧组件/API 标注新框架对应物、差异点、替代方案;迁移时按表逐页对照。

概念解释

机制上,跨端换框架的工作量主要不在"业务逻辑",而在"UI 组件与 API 对齐"。映射表是把"旧框架的每个组件/API"翻译成"新框架的对应物",避免迁移时逐个查文档。

映射表的关键是标注"差异点":两个框架同名组件但行为不一致(如滚动条默认显示与否、触摸事件冒泡语义、样式默认值),这些差异会导致 UI 不一致,必须在映射表中显式标注。

原理流程

1. 盘点旧框架使用的组件与 API
2. 在新框架找对应物
3. 标注差异点与替代方案
4. 迁移时按表逐页对照
5. 发现新差异补充进映射表

代码或图示

旧框架概念 新框架对应物 差异点
View / 容器 新框架容器组件 布局默认值、嵌套限制
Text 文本组件 样式默认值、换行行为
Image 图片组件 加载占位、缓存策略
ScrollView 滚动容器 滚动条默认、回弹行为
导航 新框架导航 页面转场、返回手势
状态管理 新框架状态方案 响应式语义差异

常见误区

  • 误区:同名组件直接用;正解:同名组件行为可能不一致,差异点会导致 UI 问题,必须逐项核对。
  • 误区:映射表建一次就完;正解:迁移过程中会不断发现新差异,映射表要持续更新。

追问

  • Q:样式迁移有什么坑? A:样式默认值、单位换算、Flex 布局行为、平台差异都可能导致 UI 不一致,详见下一题。
  • Q:网络层怎么迁? A:网络层(请求封装、拦截器、错误处理)通常是框架无关的,可大量复用,只改调用方式。

07.2.5.5-009 样式迁移有哪些坑?

一句话结论

样式迁移的坑集中在:默认样式差异、单位换算(px/dp/pt/rpx)、Flex 布局行为、平台差异、动画语义;解决方式是"迁移前统一基线、迁移后真机走查、差异分级修复"。

概念解释

机制上,跨端框架的样式系统各有差异:有的用 Web CSS 模型,有的用自定义样式表,有的用声明式 UI。默认样式(如 padding、margin、字体、行高)在不同框架下不一致,直接迁移会导致 UI 走样。

单位换算也是坑:iOS 用 pt,Android 用 dp,Web 用 px/rpx,跨端框架可能用自己的单位。设计稿通常基于一种单位,迁移时必须换算正确。

Flex 布局行为:各框架对 Flex 算法的实现可能有细微差异(如 flex-basis、align-content、gap),复杂布局会出问题。

原理流程

样式迁移步骤
  1. 确认设计稿单位与基准
  2. 统一新框架的样式默认值(reset)
  3. 逐页迁移样式
  4. 真机走查(多机型多系统版本)
  5. 差异分级:影响功能/观感优先修,边角差异排期

代码或图示

样式类别 典型坑
默认样式 padding/margin/字体/行高不一致
单位换算 px/dp/pt/rpx 换算错误
Flex 布局 gap/align-content/flex-basis 行为差异
平台差异 阴影、圆角、安全区、字体
动画 动画曲线、时长、插值器差异

常见误区

  • 误区:样式迁移就是改 CSS 类名;正解:默认值、单位、布局行为都可能导致 UI 走样,必须真机走查。
  • 误区:模拟器上看起来一致就行;正解:模拟器与真机表现不同,必须在真机上走查,详见 07.2.5.6 验收、灰度与回退预案。

追问

  • Q:怎么减少样式差异? A:在新框架里建一套统一的样式基类(设计系统),所有页面基于基类开发,而不是从零写样式。
  • Q:平台差异怎么处理? A:用条件编译或平台样式属性,区分 iOS/Android/鸿蒙的表现,不要追求完全一致。

07.2.5.5-010 埋点与监控迁移怎么处理?

一句话结论

埋点迁移按"事件名、参数、上报时机"三个维度对齐;监控迁移按"崩溃监控、性能监控、自定义指标"三类统一接入;原则是"迁移期间新旧埋点并行,验证一致后再切旧版"。

概念解释

机制上,埋点迁移的风险是"数据断档":如果新页面埋点没接好,业务方就看不到数据;如果埋点事件名不一致,历史数据就无法对比。

监控迁移的风险是"盲区":跨端页面的崩溃可能发生在 JS/Dart 层,原生监控看不到;必须接入跨端框架自己的监控,再与原生监控归并到统一看板。

原理流程

埋点迁移
  1. 盘点旧页面所有埋点事件
  2. 在新框架实现相同事件名与参数
  3. 迁移期间新旧埋点并行上报
  4. 对比数据一致性
  5. 一致后下线旧埋点

监控迁移
  1. 崩溃监控:接入跨端框架监控 + 原生监控
  2. 性能监控:首屏、帧率、内存、网络
  3. 自定义指标:与原生看板归并

代码或图示

迁移项 对齐维度 风险
埋点事件 事件名、参数、时机 数据断档
崩溃监控 跨端崩溃 + 原生崩溃 监控盲区
性能监控 首屏/帧率/内存 口径不一致
自定义指标 指标名、上报频率 看板割裂

常见误区

  • 误区:埋点迁移就是复制粘贴;正解:事件名、参数、时机都要对齐,否则历史数据无法对比。
  • 误区:跨端崩溃监控原生就能覆盖;正解:JS/Dart 层崩溃原生监控看不到,必须接入跨端框架自己的监控。

追问

  • Q:埋点并行上报会不会数据翻倍? A:会,迁移期间可接受短期数据翻倍,验证一致后下线旧埋点。
  • Q:监控怎么归并? A:统一看板,按页面标识(原生/跨端)区分,业务方看整体指标,技术侧看分来源指标。

07.2.5.5-011 迁移中的性能回归风险怎么防控?

一句话结论

性能回归防控分三步:迁移前建立旧版基线(首屏、帧率、内存、包体)、迁移中新版同口径对比、灰度中持续监控;任何指标劣化超过阈值就暂停迁移并排查。

概念解释

机制上,跨端迁移最常见的性能回归是:首屏变慢(跨端容器初始化 + 桥接开销)、滑动帧率下降(跨端渲染路径长于原生)、内存上升(引擎内存 + 桥接数据拷贝)。这些回归在小流量灰度时可能不明显,全量后才暴露。

防控的核心是"同口径对比":旧版与新版在同一机型、同一路径、同一数据规模下测量,差异可归因。如果没有基线,就无法判断"新版到底是变好了还是变坏了"。

原理流程

性能回归防控
  1. 迁移前:旧版基线测量(首屏/帧率/内存/包体)
  2. 迁移中:新版同口径对比
  3. 差异分析:
     ├─ 首屏慢 → 容器初始化/桥接/数据加载
     ├─ 帧率低 → 渲染路径/视图数/图片
     └─ 内存高 → 引擎/桥接拷贝/图片缓存
  4. 灰度中:持续监控,超阈值暂停

代码或图示

指标 迁移前基线 迁移中对比 阈值
首屏 TTI 旧版实测 新版实测 劣化不超过 X%
滑动帧率 旧版实测 新版实测 劣化不超过 X%
内存峰值 旧版实测 新版实测 劣化不超过 X%
包体 旧版实测 新版实测 增量不超过 X

常见误区

  • 误区:性能上线后再优化;正解:迁移阶段就必须对比基线,发现回归立即排查,不能带到全量。
  • 误区:用高端机测性能;正解:必须用代表机型(含中低端),高端机掩盖问题。

追问

07.2.5.5-012 迁移中的包体膨胀风险怎么防控?

一句话结论

包体膨胀来自跨端引擎、桥接库、依赖库三类;防控方式是:迁移前评估引擎增量、迁移中按需引入依赖、迁移后做包体分析与裁剪;跨端引擎增量是固定的,业务库增量要可控。

概念解释

机制上,跨端迁移会给原生 App 增加一块跨端引擎(RN 运行时、Flutter 引擎、uni-app 运行时),这部分增量是固定的,与业务无关。业务侧的包体增量来自:引入的跨端依赖库、打包资源、桥接代码。

包体膨胀的风险是:应用市场有包体限制、用户下载意愿下降、低端机存储敏感。防控的关键是"提前评估、按需引入、定期分析"。

原理流程

包体增量来源
  ├─ 跨端引擎(固定增量)
  ├─ 桥接代码(固定增量)
  ├─ 业务依赖库(按需)
  └─ 打包资源(按需)
  ↓
防控:
  1. 迁移前评估引擎增量
  2. 迁移中按需引入依赖
  3. 迁移后做包体分析,裁剪冗余

代码或图示

增量来源 是否可控 防控方式
跨端引擎 半固定 评估是否值得
桥接代码 半固定 精简桥接层
业务依赖库 可控 按需引入、定期清理
打包资源 可控 压缩、CDN 下发

常见误区

  • 误区:跨端包体增量是固定的不用管;正解:业务依赖库和资源可以持续膨胀,必须定期分析裁剪。
  • 误区:包体膨胀用户感知不到;正解:应用市场下载转化率与包体大小相关,低端机用户尤其敏感。

追问

  • Q:包体分析怎么做? A:用各端官方分析工具,拆解引擎、依赖、资源、业务代码占比,找出最大项。
  • Q:资源能不能不打包? A:图片、字体等大资源可走 CDN 下发或离线包,减少安装包体积,详见 07.2.5.6 验收、灰度与回退预案。

07.2.5.5-013 人力与排期怎么按页面复杂度分级估算?

一句话结论

页面复杂度分四级:简单(表单/设置)、中等(列表/内容页)、复杂(交易/长列表)、深度(音视频/自定义渲染);每级估算跨端开发、原生桥接、双端测试、灰度观察的人力,加总后预留缓冲。

概念解释

机制上,迁移排期的常见错误是"按页面数量平均估算"。实际上,不同复杂度页面的工作量差异巨大:简单页面 1-2 天,复杂页面 2-4 周,深度页面可能 1-2 个月。按复杂度分级估算才能准确。

人力模型:每个页面 = 跨端开发 + 原生桥接(如有)+ 双端测试 + 灰度观察。测试人力常被低估,跨端页面要双端真机回归,测试人力约为开发的 50%-100%。

除了页面本身,还要计入"迁移基建"成本:跨端容器搭建、桥接层封装、路由协议统一、监控接入、灰度配置系统。这些基建是一次性投入,但在排期时必须单列,否则会被"页面迁移"掩盖。

另一个常被低估的是"迁移期双栈维护成本":旧版缺陷修复、新版新需求开发、双端回归,都要同时进行。如果排期只算"迁移新页面"的人力,忽略了"同时维护旧版"的人力,排期必然偏紧。

原理流程

页面复杂度分级
  L1 简单:表单/设置/关于      → 1-2 天/页
  L2 中等:列表/内容/个人中心 → 3-5 天/页
  L3 复杂:交易/长列表/订单   → 1-2 周/页
  L4 深度:音视频/自定义渲染  → 2-4 周/页
  ↓
人力 = 跨端开发 + 原生桥接 + 双端测试 + 灰度观察
缓冲 = 总估算 × 20%-30%

代码或图示

复杂度 典型页面 开发 测试 桥接
L1 简单 设置/表单 1-2 天 0.5-1 天 少
L2 中等 列表/内容 3-5 天 2-3 天 中
L3 复杂 交易/订单 1-2 周 1 周 多
L4 深度 音视频/渲染 2-4 周 2 周 很多

常见误区

  • 误区:按页面数量平均估算;正解:不同复杂度页面工作量差异巨大,必须分级估算。
  • 误区:只算开发人力;正解:双端测试、灰度观察、缺陷修复都要计入,缓冲 20%-30%。

追问

  • Q:测试人力为什么这么高? A:跨端页面要双端真机回归,且迁移期要新旧对比,测试工作量约为开发的 50%-100%。
  • Q:怎么估算桥接人力? A:先盘点每个页面需要的原生能力,按能力清单估算桥接工作量,能力越多桥接越重。

07.2.5.5-014 失败案例有哪些典型模式?

一句话结论

三类典型失败模式:低估原生依赖(迁移后才发现深度原生能力无法桥接)、低估适配成本(样式与双端差异远超预期)、双栈长期并存无人收敛(旧版不冻结、新版不推进,最后变成双份维护)。

概念解释

机制上,失败不是因为"跨端框架不好",而是因为"迁移前的评估不充分"。

模式一:低估原生依赖。迁移前以为原生能力都能桥接,迁移后才发现某深度 SDK(如自定义音视频引擎、外设驱动)无法桥接,整个页面被迫回原生,迁移计划被打乱。

模式二:低估适配成本。迁移前以为 UI 组件都有对应,迁移后发现样式默认值、单位、平台差异导致大量 UI 走样,双端真机走查工作量远超预期。

模式三:双栈长期并存无人收敛。迁移期旧版不冻结新需求,新版不推进迁移,最后变成"新旧两套代码都在加功能",人力翻倍且状态混乱。

原理流程

失败模式复盘
  模式一:低估原生依赖
    迁移前能力盘点不充分 → 迁移后发现无法桥接 → 页面回退 → 计划打乱

  模式二:低估适配成本
    样式与差异评估不足 → 双端走查工作量爆炸 → 迁移延期

  模式三:双栈无人收敛
    旧版不冻结 + 新版不推进 → 双份维护 → 人力失控

代码或图示

失败模式 前兆 纠正措施
低估原生依赖 能力清单未盘点 迁移前完整盘点
低估适配成本 未做样式基线与走查 迁移前做试点页走查
双栈无人收敛 旧版仍在加新功能 明确冻结与退出条件

常见误区

  • 误区:失败是因为框架不行;正解:失败是因为迁移前评估不充分,框架只是背锅。
  • 误区:失败后就放弃跨端;正解:复盘失败模式,纠正后重新评估,可能是路径选择不对而不是方向不对。

追问

  • Q:怎么避免低估原生依赖? A:迁移前完整盘点每个页面需要的原生能力,标注现成桥接/自研桥接/无法桥接。
  • Q:怎么避免双栈无人收敛? A:明确迁移清单与时间表,旧版冻结新需求,新版承接新需求,设里程碑与退出条件。

07.2.5.5-015 什么情况下根本不该迁?

一句话结论

四种不该迁的情况:业务已稳定且无迭代诉求、迁移成本大于收益、原生依赖深度不可桥接、团队没有跨端与原生协作能力;此时保持原生或混合架构现状,不要为了"追技术"而迁。

概念解释

机制上,迁移的前提是"有明确的收益大于成本"。如果业务已经稳定、双端人力够、没有迭代压力,迁移的收益(迭代速度、多端覆盖)就不存在,成本(学习、适配、测试)却真实发生。

另一种情况是"原生依赖深度不可桥接":如果 App 核心是深度音视频、自定义渲染、外设驱动,跨端框架在这些场景下能力不足,强行迁移只会导致回退。

原理流程

不该迁的判断
  ├─ 业务稳定无迭代? → 不迁
  ├─ 迁移成本 > 收益? → 不迁
  ├─ 原生依赖深度不可桥接? → 不迁
  ├─ 团队无跨端/原生协作能力? → 不迁
  └─ 都不满足 → 评估迁移

代码或图示

情况 判断依据 建议
业务稳定无迭代 无新需求、无多端诉求 保持现状
成本 > 收益 迁移人力大于节省人力 不迁
原生依赖不可桥接 核心能力无法跨端 不迁
团队无能力 无跨端经验、无原生协作 先补能力

常见误区

  • 误区:别人都迁了我也要迁;正解:迁移决策基于自己的业务条件,不是跟风。
  • 误区:迁移是技术升级必须做;正解:迁移是业务决策,不是技术升级,没有业务收益就不迁。

追问

  • Q:怎么判断迁移成本大于收益? A:按页面复杂度分级估算迁移人力,对比双端重复开发节省的人力,净收益为负就不迁。
  • Q:业务稳定但未来可能有多端诉求怎么办? A:可以保持现状,但在架构上预留跨端嵌入能力(容器、桥接、路由),未来真要迁时成本低。

07.2.5.5-016 综合题:复盘一次迁移失败并给出修正路径

一句话结论

给定案例:某电商团队用 RN 迁移商品详情页,迁移前未盘点深度原生能力,迁移后发现商品视频播放用的是自定义原生播放器,RN 无法桥接;同时双端样式差异远超预期,走查工作量翻倍;旧版未冻结,迁移期间旧版仍在加新活动,最后变成双栈维护,项目停滞。

概念解释

这道题考的是把前面所有风险点串起来:

问题一:低估原生依赖。商品视频播放器是深度原生组件,RN 嵌入需要桥接自定义渲染 surface,工作量远超预期。修正:迁移前完整盘点原生能力清单,标注哪些可桥接、哪些必须原生嵌入。

问题二:低估适配成本。样式默认值、单位、平台差异导致 UI 走样,双端走查工作量爆炸。修正:迁移前先用试点页做样式基线与走查,确认工作量再排期。

问题三:双栈无人收敛。旧版未冻结,迁移期间仍在加新活动,新版不推进迁移。修正:明确迁移清单与时间表,旧版冻结新需求,新版承接新需求,设里程碑与退出条件。

修正路径:暂停全量迁移,先做能力盘点与试点页走查,重新评估工作量与时间表;商品详情页视频部分保留原生嵌入,UI 部分用 RN;旧版冻结,新活动统一走 RN。

原理流程

失败复盘
  1. 暂停全量迁移
  2. 盘点原生能力:视频播放器 → 原生嵌入
  3. 试点页样式走查:确认工作量
  4. 重新排期:按复杂度分级估算
  5. 旧版冻结:新活动统一走 RN
  6. 里程碑:设退出条件

代码或图示

问题 原因 修正
视频无法桥接 未盘点原生能力 原生嵌入,不强行 RN
样式走查爆炸 未做样式基线 试点页先行,确认工作量
双栈无人收敛 旧版未冻结 明确冻结与退出条件

常见误区

  • 误区:失败后就否定跨端方向;正解:失败是迁移方法不对,不是方向不对,修正方法后可以继续。
  • 误区:失败后全量回退原生;正解:暂停而不是回退,修正方法后重新推进。

追问

  • Q:怎么判断该暂停还是该放弃? A:如果修正后净收益仍为正,暂停修正后继续;如果修正后发现收益为负,放弃迁移。
  • Q:视频播放器原生嵌入怎么做? A:原生播放器作为原生 view 嵌入 RN 页面,RN 只做周围 UI,桥接播放控制事件,详见 07.2.2 React Native。