怎么用 spring-cloud-starter-gateway 启动最简网关
Spring Cloud Gateway 不能 standalone 运行，必须依赖 Spring Boot WebFlux，且不能引入 spring-boot-starter-web（否则启动失败）。常见错误是照着旧版 Spring Cloud Netflix 教程加了 MVC 依赖，结果报 ApplicationContextException: Unable to start reactive web server。
- 只保留
spring-boot-starter-webflux和spring-cloud-starter-gateway，删掉所有spring-boot-starter-web相关依赖 -
application.yml中不需要额外配置就能跑起来，但必须有server.port，默认不监听 8080（这点和 Zuul 不同） - 启动类不用加特殊注解，
@SpringBootApplication足够；Gateway 自动装配靠的是 classpath 下存在org.springframework.cloud.gateway.route.RouteDefinitionLocator
路由配置写在 application.yml 还是 Java 类里
YAML 方式适合静态、少量路由；Java DSL（RouteLocatorBuilder）更适合动态组合、条件判断或复用逻辑。容易踩的坑是混用两者却没意识到优先级：YAML 配置会覆盖 Java Bean 定义的路由，除非显式禁用自动配置。
- YAML 路由必须放在
spring.cloud.gateway.routes下，每个 route 必须有id、uri、predicates，漏掉predicates会导致该路由永远不匹配 - Java 配置推荐用
@Bean+RouteLocator，不要用RouteDefinitionLocator手动注册——后者绕过 Spring 生命周期，Filter 可能不生效 - 路径匹配注意：YAML 中
Path=/api/**的**是 Spring Cloud Gateway 的 AntPathMatcher，不是正则；想用正则得写成Path=/api/(?<segment>.*)</segment>并配合filters提取变量
GlobalFilter 和 GatewayFilter 怎么选
全局过滤器作用于所有请求，但无法按 route 细粒度控制；单个路由的 GatewayFilter 更安全，也更容易测试。很多人一上来就写 GlobalFilter 做鉴权，结果发现 /actuator/health 也被拦了，健康检查直接失效。
-
GlobalFilter适合跨域、日志、熔断器初始化等真正全局行为；顺序靠Order控制，数值越小越早执行 -
GatewayFilter推荐用工厂类（如AddRequestHeaderGatewayFilterFactory）或自定义AbstractNameValueGatewayFilterFactory，避免直接实现接口——后者要自己处理配置解析和缓存 - 自定义 Filter 里别调用
chain.filter(exchange)两次，会导致响应体写入异常；如果要短路，用exchange.getResponse().setStatusCode(...)+return Mono.empty()
为什么 lb://service-name 转发不生效
这是最常卡住的点：Gateway 默认不集成服务发现，lb:// 协议需要显式引入 spring-cloud-starter-loadbalancer（Spring Cloud 2020+），且 Eureka/Nacos 客户端必须正常注册并被 Gateway 拉取到实例列表。现象是 503 Service Unavailable，日志里出现 No servers available for service: xxx。
立即学习“Java免费学习笔记（深入）”；
- 确认
spring-cloud-starter-loadbalancer在 classpath，且版本与 Spring Cloud 版本对齐（比如 2022.0.x 对应spring-cloud-starter-loadbalancer3.2.x） -
application.yml中开启负载均衡：spring.cloud.loadbalancer.enabled=true，并确保spring.cloud.gateway.discovery.locator.enabled=false（除非你真要用服务名自动推路由） - 检查目标服务是否真的注册成功：访问
http://gateway-host:port/actuator/gateway/routes，看对应 route 的uri是否已解析为具体 IP:PORT，而不是原样留着lb://xxx
