Spring Boot能否将接口作为Controller参数，由Spring自动使用其实现类实例化？

结论 #

该需求完全可实现。问题根因为：Spring MVC默认处理非JSON、非自定义解析的接口类型请求参数时，会生成JDK动态代理对象，该代理仅实现MyInterface接口，不属于FirstImplementation或SecondImplementation的实例，因此when类型判断必然失效。

解决方案 #

方案1：使用Jackson多态反序列化（推荐，适配前后端JSON交互场景） #

直接将接口参数改为@RequestBody接收JSON参数，借助Jackson的多态反序列化能力直接生成对应实现类的实例，不会产生代理对象。
操作步骤：

1. 给密封接口添加Jackson多态注解：

import com.fasterxml.jackson.annotation.JsonSubTypes
import com.fasterxml.jackson.annotation.JsonTypeInfo

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.PROPERTY, property = "type")
@JsonSubTypes(
    JsonSubTypes.Type(value = FirstImplementation::class, name = "first"),
    JsonSubTypes.Type(value = SecondImplementation::class, name = "second")
)
sealed interface MyInterface

2. 修改Controller接口，添加@RequestBody注解：

@PostMapping // 换成Post请求接收请求体
fun findSomething(@RequestBody params: MyInterface) {
    when (params) {
        is FirstImplementation -> doSomeThing()
        is SecondImplementation -> doSomeThing()
    }
}

3. 前端请求时在JSON参数中携带type字段标识类型即可，示例请求体：

{
  "type": "first",
  "a": "test",
  "b": 1
}

方案2：自定义参数解析器（适配GET请求、表单参数场景） #

如果需要保留GET请求传参的方式，自定义HandlerMethodArgumentResolver手动解析参数并实例化对应实现类。
操作步骤：

1. 编写自定义参数解析器：

import org.springframework.web.method.support.HandlerMethodArgumentResolver
import org.springframework.core.MethodParameter
import org.springframework.web.bind.support.WebDataBinderFactory
import org.springframework.web.context.request.NativeWebRequest
import org.springframework.web.method.support.ModelAndViewContainer

class MyInterfaceArgumentResolver : HandlerMethodArgumentResolver {
    override fun supportsParameter(parameter: MethodParameter): Boolean {
        return parameter.parameterType == MyInterface::class.java
    }

    override fun resolveArgument(
        parameter: MethodParameter,
        mavContainer: ModelAndViewContainer?,
        webRequest: NativeWebRequest,
        binderFactory: WebDataBinderFactory?
    ): Any? {
        // 根据请求参数判断实例化哪个实现类，比如存在参数a则为FirstImplementation
        val a = webRequest.getParameter("a")
        val b = webRequest.getParameter("b")?.toInt() ?: 0
        return if (a != null) {
            FirstImplementation(a, b)
        } else {
            val c = webRequest.getParameter("c") ?: ""
            SecondImplementation(b, c)
        }
    }
}

2. 注册解析器到Spring MVC配置：

import org.springframework.context.annotation.Configuration
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer
import org.springframework.web.method.support.HandlerMethodArgumentResolver

@Configuration
class WebConfig : WebMvcConfigurer {
    override fun addArgumentResolvers(resolvers: MutableList<HandlerMethodArgumentResolver>) {
        resolvers.add(MyInterfaceArgumentResolver())
    }
}

方案3：临时兼容方案（已有代理场景快速修复） #

如果暂时不想改参数解析逻辑，也可以借助Spring的AopUtils工具类获取代理背后的真实对象再做类型判断：

import org.springframework.aop.support.AopUtils

@GetMapping
fun findSomething(params: MyInterface) {
    val realParams = AopUtils.getTargetObject(params) as MyInterface
    when (realParams) {
        is FirstImplementation -> doSomeThing()
        is SecondImplementation -> doSomeThing()
    }
}

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