Route没有注解属性，因为它是通过RouteDefinition解析、RouteLocator组装的不可变数据对象，不经过Spring容器Bean创建流程，故不保留注解元信息；应使用metadata传参。
Spring Cloud Gateway 的 GatewayFilterFactory 本身无法直接读取 Route 上的注解属性，因为 Route 是配置驱动（YAML/Properties 或 Java DSL）构建的，**不基于 Spring Bean + 注解的生命周期**，所以像 @Route(value = "my-route", tags = "auth") 这样的自定义注解在 Route 对象上并不存在 —— Route 实例（Route 类）是纯数据对象，没有注解元信息。
为什么 Route 没有注解属性？
Route 由 RouteDefinition 解析而来，最终是通过 RouteLocator（如 CachingRouteLocator）组装的不可变对象。它不经过 Spring 容器的 Bean 创建流程，因此不会保留任何类/方法上的注解。你写的注解如果加在配置类或方法上，**不会自动绑定到 Route 实例**。
替代方案：用 Route 的元数据（Metadata）传参
最标准、推荐的做法是把“想当注解用”的配置项，写进 Route 的 metadata 字段，然后在自定义 GatewayFilterFactory 中读取：
- YAML 配置示例：
routes:
- id: user-service
uri: lb://user-service
predicates:
- Path=/api/users/**
metadata:
auth-required: true
permissions: ["USER_READ", "USER_WRITE"]
立即学习“Java免费学习笔记（深入）”；
- Java DSL（等效）：
route(r -> r.path("/api/users/**")
.uri("lb://user-service")
.metadata("auth-required", "true")
.metadata("permissions", List.of("USER_READ", "USER_WRITE")))
- 在自定义
GatewayFilterFactory中获取：
public class AuthCheckGatewayFilterFactory
extends AbstractGatewayFilterFactory<AuthCheckGatewayFilterFactory.Config> {
public static class Config { }
@Override
public GatewayFilter apply(Config config) {
return (exchange, chain) -> {
// 获取当前匹配的 Route
Route route = exchange.getRequiredAttribute(GATEWAY_ROUTE_ATTR);
// 读取 metadata
Map<String, Object> metadata = route.getMetadata();
Boolean authRequired = (Boolean) metadata.get("auth-required");
List<String> perms = (List<String>) metadata.get("permissions");
// 后续逻辑...
return chain.filter(exchange);
};
}
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface RouteConfig {
String id();
boolean authRequired() default false;
String[] permissions() default {};
}
- 在
@Configuration类中扫描并缓存：
@PostConstruct
void initRouteConfigs() {
for (Class<?> cls : routeConfigClasses) {
RouteConfig ann = cls.getAnnotation(RouteConfig.class);
if (ann != null) {
routeConfigMap.put(ann.id(), Map.of(
"auth-required", ann.authRequired(),
"permissions", List.of(ann.permissions())
));
}
}
String routeId = route.getId();
Map<String, Object> config = routeConfigMap.get(routeId);
if (config != null && Boolean.TRUE.equals(config.get("auth-required"))) { ... }
小结：优先选 metadata，慎用注解模拟
metadata 是 Gateway 原生支持的扩展机制，轻量、清晰、可配置化，适合大多数场景；而注解方案需自行维护映射关系、增加启动开销、不利于动态路由变更，仅在已有大量注解驱动配置且需复用时考虑。不要试图给 Route 对象“加注解”，它不是被 Spring 管理的 Bean。
