跳转到内容

UUID 生成后怎么交给同事?用 AIGoCode 整理测试数据的标识映射

AIGoCode发布于 更新于

封面:测试数据主记录与关联记录的标识映射

先确定一条记录代表谁,再给它分配标识

做接口联调时,订单、订单明细和测试用户都需要标识。每个文件看起来都有 ID,合起来却可能找不到对应记录:同事重新生成了一批,明细仍引用上一批订单;第二次导入又把同一个测试用户当成新用户。

AIGoCode 工具目录提供 UUID 生成器,可以在浏览器中生成 UUID 并复制。生成之后,仍需由团队决定这些值对应什么实体、哪些引用必须一起变更。本文给出一套人工整理样本的方法,工具负责生成标识,不承担数据库约束、导入或关系维护。

第一步:给样本起业务别名

先列出本次要验收的场景,例如“新用户的一笔未付款订单”和“同一订单的两条明细”。给实体起便于沟通的别名,如 user-demo-a、order-unpaid-a、item-a-1、item-a-2。别名是说明文字,不要直接当作接口必然接受的字段。

然后查看项目接口或数据结构对 ID 的真实要求:字段类型、格式、是否由服务端生成,以及调用方能否自行指定。如果接口只接受服务器分配的标识,就应记录创建接口返回值;不能因为能生成 UUID,就把它硬填到每个 id 字段。

只有确定允许自行提供 UUID 的字段,才进入UUID 生成器准备值。先用虚构测试数据,不把生产订单、账号或真实凭据放入样本。

第二步:维护一份映射表

建议在交接文件中保存以下信息。这里的字段名称仅为记录模板,按项目实际模型调整。

实体别名标识来源实际标识被谁引用本轮动作
user-demo-a服务端返回或确认允许的生成值填完整值订单的用户引用复用
order-unpaid-a项目允许的来源填完整值两条明细的订单引用复用
item-a-1项目允许的来源填完整值本轮无下游引用新增

一个实体只在映射表中确定一次实际标识。需要引用时,从该行复制,而不是再生成一次。若标识来自服务端响应,同时记下生成它的步骤,避免拿请求里未被接受的值当成最终标识。

第三步:把“重跑”拆成两种任务

重放同一组样本,通常需要保留原映射;验证新建另一组实体,则需要单独规划新映射。实际能否重复写入、是否覆盖、是否有幂等要求,必须以项目接口约定为准,不能由 UUID 的外观推断。

交接时写明本轮属于哪一种,并给样本文件留版本。若确实要换订单标识,先列出所有引用位置,把订单和明细一起调整。不要只替换主文件中的值后就让同事执行。

第四步:比较变更,再让接收方核对

可以用目录中的文本 / 代码 Diff 对比查看两版样本的新增、删除与修改。人工重点检查:同一实体的标识是否一致、关联字段是否指向映射表中的正确实体、是否意外替换了不相关记录。Diff 展示文本变化,关系是否正确仍需结合项目模型判断。

接收方拿到文件后,先核对场景、样本版本、目标测试环境和预期记录数,再按项目既有流程做最小联调。保留接口返回与失败信息,用于区分格式拒绝、引用不存在和重复写入等问题;不要为了让导入通过直接改生产数据。

交接完成应留下什么

一份可复用的测试样本,至少应带场景说明、实体映射、标识来源、关联方向、重跑约定和本轮实际结果。生成了一串 UUID 只是准备材料的一步;当同事能解释每个值代表谁、改动会影响哪里,才有条件继续联调。

如样本还需从 CSV 转成 JSON,可再核对CSV 转换后的编号、日期和空值。字段格式验收与实体关系验收分开记录,便于定位问题。