如何基于Spring Boot API接口自动生成Java/Kotlin Feign Client？

针对你的需求，这里提供几种无需OpenAPI生成器的可行方案：

方案1：自定义注解处理器 #

编写自定义注解处理器，扫描你的Spring API接口，解析注解与方法签名后自动生成Feign Client代码，适合项目长期复用。

核心实现思路： #

• 继承AbstractProcessor，在process方法中扫描带有@RequestMapping的接口
• 解析接口上的@RequestMapping路径，作为FeignClient的path属性
• 遍历接口方法，提取@PostMapping路径、@RequestBody参数、返回类型等信息
• 使用JavaPoet/KotlinPoet工具生成规范的Feign Client接口文件

简化代码示例：

override fun process(annotations: MutableSet<out TypeElement>?, roundEnv: RoundEnvironment?): Boolean {
    roundEnv?.getElementsAnnotatedWith(RequestMapping::class.java)?.forEach { apiElement ->
        val apiInterface = apiElement as TypeElement
        val basePath = apiInterface.getAnnotation(RequestMapping::class.java).value.first()
        
        // 构建Feign Client接口定义
        val clientSpec = TypeSpec.interfaceBuilder("${apiInterface.simpleName}Client")
            .addAnnotation(
                AnnotationSpec.builder(FeignClient::class.java)
                    .addMember("contextId", "\$S", "${apiInterface.simpleName.lowercase()}Client")
                    .addMember("name", "\$S", "service")
                    .addMember("path", "\$S", basePath)
                    .build()
            )
        
        // 遍历API方法，生成对应Feign方法
        apiInterface.enclosedElements.filterIsInstance<ExecutableElement>().forEach { method ->
            val postPath = method.getAnnotation(PostMapping::class.java).value.first()
            val requestParam = method.parameters.first()
            val returnType = method.returnType
            
            clientSpec.addMethod(
                MethodSpec.methodBuilder(method.simpleName.toString())
                    .addAnnotation(AnnotationSpec.builder(PostMapping::class.java).addMember("value", "\$S", postPath).build())
                    .addParameter(
                        ParameterSpec.builder(requestParam.asType(), requestParam.simpleName.toString())
                            .addAnnotation(RequestBody::class.java)
                            .build()
                    )
                    .returns(returnType)
                    .build()
            )
        }
        
        // 生成代码文件
        FileSpec.builder(apiInterface.enclosingElement.toString(), "${apiInterface.simpleName}Client")
            .addType(clientSpec.build())
            .build()
            .writeTo(processingEnv.filer)
    }
    return true
}

方案2：Freemarker模板生成 #

通过Freemarker定义Feign Client的代码模板，结合反射/ASM读取API接口元数据，填充模板生成代码，适合快速实现。

步骤： #

1. 编写Freemarker模板文件（feign-template.ftl）：

@FeignClient(
    contextId = "${contextId}",
    name = "service",
    path = "${basePath}"
)
interface ${clientName} {
<#list methods as method>
    @PostMapping("/${method.path}")
    fun ${method.name}(
        @RequestBody request: ${method.requestType}
    ): ${method.returnType}
</#list>
}

2. 编写工具类，读取API接口的类信息，提取模板所需的参数（contextId、basePath、方法列表等）
3. 调用Freemarker引擎渲染模板，生成Feign Client代码文件

方案3：IDE自定义模板/插件 #

在IntelliJ IDEA等IDE中，通过自定义代码模板或轻量插件，实现右键API接口一键生成Feign Client的功能，适合日常开发快速生成。

原问题翻译 #

OpenAPI生成器能否生成接口形式的Feign客户端？

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