什么时候用 v4
联调里最常见的是给 id、requestId、traceId 占位:后端还没定雪花还是 UUID,前端表格、Redux store 和 Storybook 先要有不撞车的字符串;v4 走随机 122 bit,格式固定为 8-4-4-4-12 连字符小写十六进制,和 PostgreSQL uuid、CHAR(36)、Java UUID.randomUUID() 默认形态一致,Mock 阶不要用自增整数冒充,否则合并分支时主键策略一改全链都要返工。
页面 UUID 生成器 只出 v4,不搞 v1 时钟、v3/v5 命名空间 hash;需要按时间排序的 id 用 ULID 生成器,和本文场景不同。生成器用 crypto.getRandomValues 在浏览器里填位,默认点一次出 5 条,数量框 1–50,多于 50 要分批——别指望一条 SQL 里塞几百个占位符一次粘完。
生成与复制
选好「数量」点生成,列表逐条展示,行尾复制单条;生成 2 条以上时出现「复制全部」,换行 ` ` 分隔,贴进 Excel 或脚本最合适。
每条应是 36 字符、第三段以 4 开头(version nibble)、第四段首位 8/9/a/b 之一(variant);若从聊天工具粘来带上零宽字符,先丢进 文本去重 或肉眼删空格再起一行,否则 ORM 校验 uuid 失败。
WoDeTool 不把生成结果上传服务器做存档,关标签即清;若有合规要求,不要把真实客户主键当样例贴进工单,用占位 UUID 即可。
接到 Mock 与 seed
和 Mock 测试数据 组合:在 schema 里把 id 标成 string/format uuid,生成一批 JSON 后,若某条要手动指定主键,用本页 UUID 替换其中一行 id 再 JSON 格式化 扫格式;CSV 联调可走 JSON 转 CSV。
写 SQL seed:先列 INSERT INTO app_user (id, email) VALUES (...), (...),UUID 列用 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx' 引号包起来;批量表名改前缀时用 文本替换 限定范围,别误改列名。
OpenAPI / Swagger 的 example 字段常要合法 uuid 字符串,不必为一条 example 开终端 python -c;生成一条复制进 YAML,若与 JSON↔YAML 转换后的 mock 并存,用 JSON 对比 看是否只有 id 不同。
端到端实操流程(图示)
隐私、边界与排查
随机 id 不含业务语义,适合脱敏演示;别把生产库里扒出来的真 uuid 当公开 example——有些团队把 uuid 当不可猜测令牌用。
若 E2E 测试要固定种子,应在测试代码里 mock randomUUID,浏览器批量生成不适合做每日回归的恒定数据;性能压测堆积百万行请用数据库 gen_random_uuid() 或应用侧批量 API,浏览器 50 条上限拦不住思路但拦得住规模。
常见问题
Q一次最多几条?
A界面限制 1–50;更多时分批生成再合并文本,或写脚本调用运行时的 crypto.randomUUID()。
Q和 Mock 测试数据 自动出的 id 有什么区别?
AMock 工具按 schema 随机填字段;当你要 指定某几条主键 或只要纯 uuid 列表、不要整份 JSON,用本页更快。
Q需要有序 id 给日志关联怎么办?
Av4 不可排序;用 ULID 生成器 或后端雪花,别强行按 uuid 字符串排序。
QMySQL 里写成 BINARY(16) 怎么存?
A本页输出 string;入库 UUID_TO_BIN/uuid 函数在 DB 侧转换,浏览器工具不负责十六进制无连字符格式。
实操示例(分步)
1. 产品要在 staging 演示「用户列表」五页,后端 GET /users 尚未部署,需要 8 条带 id 的 JSON。
2. 打开 Mock 测试数据 按 schema 生成骨架;打开 UUID 生成器,数量选 8,点生成。
3. 「复制全部」,按行把每个 uuid 填进对应对象的 id 字段(可配合 JSON 格式化 编辑)。
4. 把 email 改成 @example.com 占位,保存到前端 mocks/users.json。
5. 用 JSON 格式化 验证无尾逗号;用 JSON 对比 和昨日样例比,确认只有数据行变化。
6. Storybook 需要单条固定 id:从列表复制第 1 条写入 story 参数。
7. 写 Flyway seed:INSERT INTO users (id,name) VALUES (' 替换 为第二条。
8. 若 QA 报「uuid invalid」,检查粘贴是否缺段或含全角连字符;重新生成一条覆盖。