Netflix/zuul
 Watch   
 Star   
 Fork   
简介统计版本
8 days ago
zuul
Netflix

v4.1.9

What's Changed

New Contributors

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.8...v4.1.9

9 days ago
zuul
Netflix

v4.1.8

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.7...v4.1.8

21 days ago
zuul
Netflix

v4.1.7

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.5...v4.1.7

2026-09-02 00:43:33
zuul
Netflix

v4.1.5

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.4...v4.1.5

2026-08-13 05:04:41
zuul
Netflix

v4.1.4

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.3...v4.1.4

2026-07-28 09:14:01
zuul
Netflix

v4.1.3

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.2...v4.1.3

2026-07-28 02:28:53
zuul
Netflix

v4.1.2

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.1...v4.1.2

2026-07-21 01:28:08
zuul
Netflix

v4.1.1

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.1.0...v4.1.1

2026-07-16 01:49:21
zuul
Netflix

v4.1.0

What's Changed

Full Changelog: https://github.com/Netflix/zuul/compare/v4.0.0...v4.1.0

2026-07-08 08:51:11
zuul
Netflix

v4.0.0

Zuul 4.0.0 replaces the RxJava Observable based async filter execution with CompletableFuture. RxJava 1.x is long past end-of-life, and moving to CompletableFuture lets the filter runner drop its custom RxJava Scheduler and Observer for plain JDK primitives.

Breaking changes

  • ZuulFilter.applyAsync now returns CompletableFuture<O> instead of Observable<O>. The Observable-based method is renamed to applyAsyncObservable and deprecated. Both have default bridge implementations on the interface, so a filter can override either one (#2075)
  • The debugRouting / debugRequest infrastructure is removed (#2078)
  • Connection draining is now event-based rather than channel-attribute based (#2161). Zuul-core fires a ConnectionCloseEvent down the pipeline instead of setting a channel attribute that every write has to check, so a graceful shutdown starts immediately on the event instead of waiting for the next response (an idle HTTP/1.1 connection can be closed right away), and OOS closes get random jitter to spread them out. The close handlers were reworked and CLOSE_AFTER_RESPONSE was removed - see Connection draining below
  • SessionContext no longer extends HashMap<String, Object>; it now wraps one via composition (#2171) and is @NullMarked (#2174). The common Map methods are re-exposed directly, but code that relied on it being a Map needs updating, and nullmarking turns the accessors @Nullable which can surface new NullAway warnings in consumers. The getRouteHost / setRouteHost / removeRouteHost accessors are removed - use the generic get/set with your own Key<T>.

Migrating a filter

A filter overriding applyAsync to return an Observable will not compile against 4.0.0. The minimal fix is a one-line rename:

Before:

@Override
public Observable<HttpResponseMessage> applyAsync(HttpRequestMessage request) {
    return service.call(request).map(this::toResponse);
}

After:

@Override
public Observable<HttpResponseMessage> applyAsyncObservable(HttpRequestMessage request) {
    return service.call(request).map(this::toResponse);
}

The default applyAsync bridges applyAsyncObservable back to a CompletableFuture, so the rest of the filter keeps working unchanged. The filter should be rewritten to return a CompletableFuture directly and delete applyAsyncObservable. applyAsyncObservable will be removed entirely in a later 4.x release.

Connection draining

Consumers that build their own channel pipelines need small updates:

  • The close and expiry handlers moved to the com.netflix.netty.common.close package
  • HTTP/2 connection close now lives on the connection pipeline, not the stream - drop any stream-level close-handler wiring
  • CLOSE_AFTER_RESPONSE / the allow_then_close rejection type is gone; throttled connections just close

Additional Changes

Also in this release: lazy hashCode caching (#2085), Objects.requireNonNull / @NonNull over preconditions (#2090), removal of unused classes (#2153), and a switch to typed SessionContext.Key<T> keys instead of stringly-typed context keys, both in the filter runner (#2167) and across SessionContext's own internal state (#2174).

Full Changelog: https://github.com/Netflix/zuul/compare/v3.6.21...v4.0.0