Spring OpenApi Generator未自动导入Set依赖的问题求助

问题背景 #

使用org.openapitools:openapi-generator-gradle-plugin:6.6.0生成Spring API接口时，当OpenAPI定义中array参数设置了uniqueItems: true，生成器会将参数类型转为Set<String>，但未自动添加java.util.Set的导入语句，导致编译报错。

正确解决方案 #

方案1：精准配置Set的导入映射 #

在Gradle的openApiGenerate任务中添加importMappings，明确指定Set对应的Java类导入：

修改你的Gradle配置如下：

def apiPackageFolder = 'com.example.test.api'
def modelPackageFolder = 'com.example.test.model'

openApiGenerate {
    generatorName.set("spring")
    inputSpec.set("${projectDir}/specs/test.yaml")
    outputDir.set("${projectDir}/src/main/java-generated")
    apiPackage.set("${apiPackageFolder}")
    modelPackage.set("${modelPackageFolder}")
    
    // 强制生成器导入java.util.Set
    importMappings.put("Set", "java.util.Set")
    
    configOptions = [
            useSpringBoot3: "true",
            openApiNullable: "false",
            useOptional: "true",
            "interfaceOnly" : "true",
            sourceFolder: ""
    ]
}
compileJava.dependsOn tasks.openApiGenerate

方案2：通配符导入java.util包（可选） #

如果希望一次性导入所有java.util下的集合类，也可以用通配符映射：

importMappings.put("Set", "java.util.*")

这种方式会生成import java.util.*;，包含Set、List等所有java.util下的类，适合多个集合类型都需要导入的场景。

原理说明 #

OpenAPI Generator 6.6.0版本的Spring代码生成器在处理uniqueItems: true的array参数时，逻辑上会将数组转为Set类型，但存在导入语句生成的遗漏。通过importMappings配置可以强制生成器为指定类型添加正确的导入语句，解决编译问题。

相比你之前用importMappings.put("java.util.List","java.util.*")的临时方案，精准映射Set的方式更合理，避免不必要的通配符导入。

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