骨架没问题,我补三个上线后基本都会踩的点:StripPrefix 的语义、响应式里别碰 ThreadLocal、以及超时默认值。
1)StripPrefix=2 是「砍掉路径前 2 段」,不是匹配前缀。/api/user/123 砍 2 段只剩 /123,很多后端接口写的是 /user/123,结果 404。想让后端收到 /user/123 就用 StripPrefix=1;更稳的写法是显式重写:
- RewritePath=/api/user/(?<seg>.*), /user/$\{seg}
正则写法能一眼看出前后对应关系,比数段数靠谱。
2)鉴权过滤器写 GlobalFilter + Ordered,别用 OncePerRequestFilter。
Servlet 那套在 WebFlux 栈里不生效。另外用户上下文千万别塞 ThreadLocal——网关的线程是复用的,串号是迟早的事,放 exchange.getAttributes() 或 mutate 请求头往下传:
@Component
public class AuthFilter implements GlobalFilter, Ordered {
public Mono<Void> filter(ServerWebExchange ex, GatewayFilterChain chain) {
String token = ex.getRequest().getHeaders().getFirst("Authorization");
if (token == null) {
ex.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);
return ex.getResponse().setComplete();
}
ServerHttpRequest req = ex.getRequest().mutate().header("X-User", "u1").build();
return chain.filter(ex.mutate().request(req).build());
}
public int getOrder() { return -100; }
}
如果 filter 里要查 Redis 或调鉴权服务,务必写成 Mono.fromCallable(...).subscribeOn(Schedulers.boundedElastic()) 再链式返回,直接 .block() 会把事件循环线程卡死,压测时表现为整站排队。
3)默认没有响应超时。
下游服务卡住,网关的请求会一直挂着不释放。建议在配置里显式设:
spring:
cloud:
gateway:
httpclient:
connect-timeout: 1000
response-timeout: 5s
排查时用 /actuator/gateway/routes 看实际生效的路由,比来回翻 yaml 快得多(记得在 management.endpoints 里 expose 出来)。
见习用户






