本文详解 spring 中自定义 http 方法注解（如 @get）的实现原理，重点解决因 @requestmapping 属性未正确继承导致的 “ambiguous mapping” 映射冲突问题，并提供基于 @aliasfor 的完整、可复用的 kotlin 实现方案。

本文详解 spring 中自定义 http 方法注解（如 @get）的实现原理，重点解决因 @requestmapping 属性未正确继承导致的 “ambiguous mapping” 映射冲突问题，并提供基于 @aliasfor 的完整、可复用的 kotlin 实现方案。

在 Spring 中，@GetMapping、@PostMapping 等组合注解之所以能安全复用且不引发映射冲突，核心在于它们通过 @AliasFor 显式桥接了底层 @RequestMapping 的关键属性（尤其是 value/path），确保每个自定义注解实例的路径信息能准确传递给 Spring MVC 的请求匹配器。而原始实现中直接在注解上重复声明 @RequestMapping(method = [GET]) 但未指定 value，会导致所有 @Get 方法默认映射到根路径 /，从而触发 Ambiguous mapping 异常。

正确做法是：将自定义注解设计为 @RequestMapping 的“语义别名”，而非简单叠加。关键在于使用 @get:AliasFor 将注解自身的 value、path、name 等参数精准委托给 RequestMapping 对应属性。以下是推荐的 Kotlin 实现：

@Target(AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY_GETTER, AnnotationTarget.PROPERTY_SETTER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@RequestMapping(method = [RequestMethod.GET])
annotation class Get(
    @get:AliasFor(annotation = RequestMapping::class, attribute = "name")
    val name: String = "",

    @get:AliasFor(annotation = RequestMapping::class, attribute = "value")
    vararg val value: String = [],

    @get:AliasFor(annotation = RequestMapping::class, attribute = "path")
    val path: Array<string> = [],

    @get:AliasFor(annotation = RequestMapping::class, attribute = "params")
    val params: Array<string> = [],

    @get:AliasFor(annotation = RequestMapping::class, attribute = "headers")
    val headers: Array<string> = [],

    @get:AliasFor(annotation = RequestMapping::class, attribute = "consumes")
    val consumes: Array<string> = [],

    @get:AliasFor(annotation = RequestMapping::class, attribute = "produces")
    val produces: Array<string> = []
)</string></string></string></string></string>

✅ 关键说明：

• @get:AliasFor 中的 attribute 参数必须显式指定（如 "value"），否则 Spring 无法识别代理关系；
• 所有被 @AliasFor 标记的参数将与 RequestMapping 同名属性双向同步，确保 Spring 解析时能提取到真实路径；
• method = [RequestMethod.GET] 保留在元注解中即可，无需在每个方法上重复配置。

使用示例：

@RestController
class Ctrl {
    @Get("/test-get")      // → RequestMapping(value = ["/test-get"], method = GET)
    fun testGet() = "test get"

    @Get("/test-get2", produces = ["application/json"])
    fun testGet2() = mapOf("msg" to "test get2")
}

⚠️ 注意事项：

• 自定义注解不可省略 @RequestMapping(method = [...]) 元注解，否则 Spring 不识别其为请求映射；
• 若需支持 @Get(name = "xxx") 等高级特性，必须为每个 @AliasFor 明确 attribute，否则编译期无报错但运行时失效；
• 组合注解中禁止出现同名但未桥接的属性（如同时声明 val value: String 和 @get:AliasFor(...)），否则引发 AnnotationConfigurationException。

通过此方式实现的 @Get 完全兼容 Spring MVC 的映射注册机制，可无缝替代内置注解，同时保持代码语义清晰与扩展灵活性。