Gradle环境JPA Buddy缺失Liquibase changelog生成选项问题

问题表现 #

使用JPA Buddy基于项目实体类生成Liquibase changelog时，操作界面未展示Liquibase相关功能选项，仅显示其他可用功能，无法进入对应生成流程。
正常操作流程的界面会展示明确的Liquibase功能入口：

异常状态下界面无对应入口：

排查&解决方法 #

该问题由项目配置或插件识别异常导致，和操作流程无关，按以下顺序排查即可：

• 校验项目依赖配置
  缺失Liquibase核心依赖是最高发的触发原因：
  • Gradle项目检查build.gradle中是否引入Liquibase核心依赖，参考配置：

    dependencies {
        implementation 'org.liquibase:liquibase-core'
    }
    

  • Maven项目检查pom.xml中是否引入对应依赖，禁止将Liquibase依赖的作用域设置为test、provided这类非主编译范围，也不要错误配置为仅运行时加载的scope，否则IDE和JPA Buddy无法识别到项目启用了Liquibase能力
• 校验插件版本兼容性
  旧版本JPA Buddy与新版本IDE、IDEA社区版存在功能适配问题，直接打开IDE插件市场，将JPA Buddy更新至最新正式版，重启IDE后重试操作即可。
• 校验项目Facet识别状态
  打开IDE项目结构设置，查看Facets列表中是否存在JPA、Liquibase的对应配置项；如果缺失则手动添加对应Facet，关联好项目的实体类扫描路径、Liquibase changelog文件存放目录，确保插件可正确识别项目技术栈。
• 校验JPA Buddy功能开关
  打开IDE设置页，进入Tools -> JPA Buddy配置项，确认Liquibase相关功能开关未被手动关闭。

内容的提问来源于stack exchange，提问作者Felipe Hogrefe Bento