本文详解如何通过 @AliasFor 机制将自定义注解（如 @Get）安全桥接到 @RequestMapping，避免“Ambiguous mapping”错误，并实现与 @GetMapping 一致的行为。

本文详解如何通过 `@aliasfor` 机制将自定义注解（如 `@get`）安全桥接到 `@requestmapping`，避免“ambiguous mapping”错误，并实现与 `@getmapping` 一致的行为。

在 Spring 中，@GetMapping、@PostMapping 等组合注解之所以能被框架正确识别并生成唯一映射，关键在于它们并非简单地“嵌套”@RequestMapping，而是通过 @AliasFor 显式声明属性委托关系，使 Spring 的 AnnotationUtils 和 RequestMappingHandlerMapping 能准确解析每个注解实例的 value、path、method 等元数据。而你在初始实现中直接在注解上重复声明 @RequestMapping(method = [GET])，却未将 value 属性桥接到父注解——这导致所有 @Get 方法默认使用空路径 value = []，Spring 将其统一解析为根路径 /，从而引发 “Ambiguous mapping” 错误。

正确做法是：将自定义注解设计为 @RequestMapping 的语义别名（meta-annotation），而非静态组合。核心是使用 @AliasFor 将自定义注解的属性（如 value、path、name 等）精确映射到 @RequestMapping 对应属性，确保 Spring 在扫描时能提取出差异化路径信息。

以下是符合 Spring 官方规范的 @Get 注解完整实现（Kotlin）：

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

    /**
     * 别名：对应 @RequestMapping.value（主路径）
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "value")
    vararg val value: String = [],

    /**
     * 别名：对应 @RequestMapping.path（等价于 value，保留兼容）
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "path")
    val path: Array<String> = [],

    /**
     * 别名：对应 @RequestMapping.params
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "params")
    val params: Array<String> = [],

    /**
     * 别名：对应 @RequestMapping.headers
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "headers")
    val headers: Array<String> = [],

    /**
     * 别名：对应 @RequestMapping.consumes
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "consumes")
    val consumes: Array<String> = [],

    /**
     * 别名：对应 @RequestMapping.produces
     */
    @get:AliasFor(annotation = RequestMapping::class, attribute = "produces")
    val produces: Array<String> = []
)

✅ 关键要点说明：

• @AliasFor 必须明确指定 annotation（目标注解类）和 attribute（目标属性名），否则 Spring 无法建立映射；
• 所有需透传的 @RequestMapping 属性都应提供 @AliasFor 声明，否则将回退为默认值（如空数组 → /）；
• @RequestMapping(method = [...]) 作为元注解保留在注解定义上，用于声明固定 HTTP 方法，无需（也不应）用 @AliasFor 代理 method 属性；
• @ResponseBody 不应直接写在 @Get 上——它属于方法级行为，应由控制器类（如 @RestController）或单独添加，否则可能干扰响应处理链。

使用示例：

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

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

⚠️ 注意事项：

• 自定义组合注解必须使用 RUNTIME 保留策略，否则 Spring 无法在运行时读取；
• 若需支持 Kotlin 空安全或 Java 调用，建议为 vararg value 提供非空默认（如 ["/"]），但更推荐显式传参以避免歧义；
• Spring Boot 2.6+ 默认启用 RequestMappingHandlerMapping#setUseTrailingSlashMatch(false)，路径匹配更严格，请确保测试路径末尾斜杠一致性；
• 可通过 @TestConfiguration + MockMvc 编写集成测试验证映射是否唯一且可访问。

至此，你的 @Get 将完全兼容 Spring MVC 的映射解析器，不再触发冲突报错，真正成为 @GetMapping 的轻量级替代方案。