本文详解 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> = []
)✅ 关键说明：
- @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 的映射注册机制，可无缝替代内置注解，同时保持代码语义清晰与扩展灵活性。
