JHipster 7.9.3修改实体违反Liquibase原则致运行失败咨询

问题背景 #

1. 创建包含初始字段的JDL文件（如Attachment实体，含id和url字段）
2. 执行jhipster import-jdl attachment.jdl生成代码
3. 启动服务，Liquibase应用初始变更集（如20240612174911_added_entity_Attachment.xml）完成表创建
4. 向JDL中添加新字段（如contentType），重新执行jhipster import-jdl attachment.jdl
5. JHipster直接修改了已存在的初始变更集文件，添加新字段定义
6. 再次启动服务时，Liquibase检测到变更集校验和不匹配，启动失败

这确实违反了Liquibase"不修改已应用变更集"的核心原则——已执行的变更集一旦被修改，校验和会发生变化，Liquibase会判定变更集被篡改，阻止执行。

这是JHipster的局限吗？ #

是的，JHipster的import-jdl命令默认行为是全量重新生成实体相关代码与初始变更集，而非增量生成新的变更集。这在实体尚未被部署到任何环境、初始变更集未被执行时没问题，但一旦变更集已被应用，就会触发校验和错误。这是JHipster在实体更新流程上的设计特性，虽非bug，但确实不符合Liquibase的最佳实践。

解决方案 #

方案1：使用JHipster实体更新命令（推荐） #

避免直接用import-jdl全量更新，改用JHipster的实体交互式更新功能：

• 执行命令：jhipster entity Attachment
• 选择Update an existing entity选项
• 按照提示添加新字段（如contentType）
• 完成后，JHipster会生成新的Liquibase变更集文件（命名格式如20240613123456_added_field_contentType_to_Attachment.xml），并自动添加到master.xml中
• 重启服务，Liquibase会执行新的变更集，不会触发校验和错误

这种方式完全符合Liquibase的原则，是JHipster官方推荐的实体增量更新方式。

方案2：手动修复已修改的变更集（适用于已用import-jdl修改的场景） #

如果已经用import-jdl修改了初始变更集，且变更集已在环境中执行：

1. 恢复初始变更集文件到修改前的状态（比如从版本库回滚）
2. 生成新的增量变更集：
   • 确保本地数据库已包含新字段（可临时启动服务，执行liquibase clearCheckSums跳过校验和错误，启动后数据库会有新字段，再停止服务）
   • 执行Liquibase diff命令生成变更集：

     liquibase diffChangeLog --changeLogFile=src/main/resources/config/liquibase/changelog/20240613_add_contentType_to_Attachment.xml
     

   • 检查生成的变更集，确保仅包含添加contentType字段的操作
3. 将新变更集添加到src/main/resources/config/liquibase/master.xml中
4. 重启服务，Liquibase会执行新的变更集完成字段添加

方案3：本地开发环境临时解决（仅适用于未部署的场景） #

如果仅在本地开发，变更集未提交到版本库或部署到其他环境：

• 直接删除Postgres数据库中databasechangelog表对应初始变更集的记录
• 或者执行liquibase clearCheckSums重置校验和
• 重启服务，修改后的变更集会重新执行

但这种方式不适合已部署的环境，仅用于本地开发初期的快速调整。

内容的提问来源于stack exchange，提问作者J D R