Spring Boot Gradle中OpenAPI Generator模型后缀配置无效的解决方案

下面给你几个可行的排查和解决方向：

1. 先清缓存重新生成试试 #

有时候旧的生成文件缓存会导致新配置不生效，直接执行：

./gradlew clean openApiGenerate

先把build目录清干净再重新生成，看看后缀有没有加上。

2. 检查API规范里的模型定义 #

如果你的api.yaml里给模型加了title字段，生成器会优先用title的值，不会自动加后缀。比如这种情况：

components:
  schemas:
    Employee:
      title: Employee  # 这里会覆盖自动添加的后缀
      type: object
      properties:
        id:
          type: integer

解决办法是要么删掉title字段，要么在configOptions里加一行useModelNameAsTitle: 'false'，让生成器忽略title，用schema名称加后缀：

configOptions = [
        // 其他原有配置...
        modelSuffix: 'DTO',
        useModelNameAsTitle: 'false'
]

3. 确认参数名和版本兼容性 #

你用的是7.7.0版本的插件，modelSuffix这个参数名是对的，但如果还是不行，可以试试换成modelNameSuffix（部分旧版本的生成器用这个名字），然后重新生成测试。

4. 查看日志确认配置是否被读取 #

执行生成命令时加上-i参数看详细日志，搜索modelSuffix，确认配置有没有被正确识别：

./gradlew openApiGenerate -i | grep "modelSuffix"

如果日志里找不到这个参数，说明你的configOptions语法可能有问题，检查一下逗号、引号这些有没有写错。

5. 自定义模板兜底 #

如果上面的方法都没用，就直接改生成模板：

• 从OpenAPI Generator的官方模板库下载Spring生成器的model.mustache和modelInterface.mustache模板文件。
• 把模板里的{{classname}}替换成{{classname}}DTO。
• 在openApiGenerate配置里指定自定义模板的目录：

openApiGenerate {
    // 其他原有配置...
    templateDir = file('src/main/resources/openapi-templates').absolutePath
}

这样生成的模型类名就一定会带上DTO后缀了。

内容的提问来源于stack exchange，提问作者Abhijit Mondal Abhi