先判断差异来自组件自身还是页面环境:如果同一组件在A页面正常、在B页面异常,而两页引用的组件版本、构建产物一致,问题通常出在页面级样式、容器宽度、数据形态或初始化时机;如果版本或构建产物不一致,则属于发布一致性问题。验收样例要围绕这两种条件分别构造,不能只截一张正常页面的图就签字。
当确认两页加载的是同一份组件代码,验收重点转向宿主环境。此时应固定组件输入,只改变页面变量,逐个复现差异。
可执行动作:为每个变量建一个最小页面,只保留该变量,其余保持一致。若窄栏下复现、宽栏下不复现,就把容器宽度写入验收样例的必测项,而不是笼统写“显示正常”。这一步的结果决定下一步:能稳定复现的变量进入回归清单,无法复现的变量需要继续缩小范围,不能直接判定为偶发问题而放过。
如果两页引用的组件文件哈希、构建时间或依赖版本不同,页面表现差异只是发布不一致的症状。此时构造验收样例的意义有限,应先统一产物。
判断依据包括:两页请求到的组件资源路径是否相同、构建产物是否来自同一次发布、是否存在缓存导致旧版本被继续使用。假设某组件在列表页加载的是新构建产物,在详情页仍命中旧缓存,那么同一交互在详情页失效并不说明组件本身有问题。这是假设例子,用于说明比较方法:把资源标识和构建标识对齐后再复测,若差异消失,验收样例应记录发布一致性检查项;若差异仍在,才回到条件一的页面环境排查。
样例不是截图集合,而是可重复执行的判定单元。每个样例至少写明:组件标识与版本、页面路径或页面类型、容器条件、数据输入、预期表现、实际表现、判定结论。
当同一组件在多个页面出现时,优先选差异最大的两个页面作为对照样例,再补一个中间态页面。这样能用最少样例覆盖最大变量范围。
并非所有差异都需要阻断验收。如果差异只出现在非关键页面的装饰性间距、且不影响信息读取和操作完成,可以记录为已知差异并约定后续处理。判断标准是:用户能否在该页面完成主要任务。若不能,差异必须回到条件一或条件二继续定位;若能,且差异稳定可描述,可降级为观察项。
降级不等于忽略。观察项仍需写清复现条件和影响范围,否则后续改版时会被误认为新问题。对于涉及表单提交、支付、登录等关键路径的组件,不适用降级,必须逐项复现并确认。
完成上述排查后,验收文档应体现两种条件的处理路径:版本一致时按页面环境变量逐项验证,版本不一致时先统一发布再复测。每个通过的样例保留可复现的最小条件,每个不通过的样例写明下一步动作和责任人。这样,同一组件在不同页面的表现差异就从模糊的“感觉不对”变成可交接、可回归的验收依据,后续页面新增或容器调整时也能直接复用这批样例。