返回 Bug 清单
BUG-0356project-13中已修复data-consistency

种子数据字段名与 Hibernate 实际建表漂移 —— seed 脚本一跑就断

发现:2026-10-01验证:2026-10-09置信度:90%

症状

种子数据导入报未知列错误;JSON 种子文件与实体定义分属两处维护,实体改字段时 seed 没有跟着改。

根因

种子数据是『手工对齐 schema 的第二份结构定义』,与实体类之间没有校验桥梁——它只在导入那一刻被验证,之前的所有漂移都不可见。

修复方案

1) 修正字段名对齐实体(tagline→catchphrase); 2) seed 导入前置校验:按实体元数据反射检查 JSON key 集合,未知/缺失字段直接列清单报错; 3) seed 文件尽量由实体序列化样例反推生成,而不是手写。

检测命令

python -c 'json keys vs 实体字段' 对账;或导入失败信息中的 unknown column

错误签名

seed_virtual_universe personas 用 tagline 字段,实体/建表实际为 catchphrase → 导入即失败

技术信息

来源项目

project-13

标签

seed-data, schema-drift, hibernate, data-import