如何定义Model Specification文件 解决JHipster JDL运行报错问题

报错原因 #

这个At least one type of specification is required报错是你在JDL中开启了enableSwaggerCodegen true配置后，SpringDoc的模型规范校验触发的提示：你定义的所有实体都没有配置对应的OpenAPI模型规范说明，所以校验不通过。这个是DEBUG级别的日志，不会影响应用核心功能运行，仅会在控制台输出冗余报错。

解决方案 #

你可以根据自己的需求选择任意一种方案处理：

• 不需要Swagger代码生成能力的话，直接修改JDL配置，删除enableSwaggerCodegen true字段，或者将其改为enableSwaggerCodegen false，重新生成项目代码即可消除报错。
• 需要保留Swagger代码生成能力的话，给所有JDL定义的实体、字段补充apiDoc规范说明即可，示例如下：

// 补充apiDoc注解后的实体定义示例
entity Product {
  name String apiDoc("产品名称")
} apiDoc("产品信息实体")

entity Origin { 
  name String apiDoc("产地名称")
} apiDoc("产地信息实体")

所有实体补充完成后重新生成代码，校验就会正常通过。

• 不想修改JDL重生成代码的话，直接修改项目的src/main/resources/config/application.yml配置文件，添加配置关闭SpringDoc校验即可：

springdoc:
  api-docs:
    validator:
      enabled: false

内容的提问来源于stack exchange，提问作者ajayramesh