NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central, #740 by repository stars
gRPC BinderChannel
Latest stable
1.85.1
Last release 1 months ago
21 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
102 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
api: Stabilize io.grpc.CallCredentials (#10208, #10211). thisUsesUnstableApi() is @Deprecated and has a default implementation. CallCredentials implem…
SynchronizationContext class (#10130).io.grpc.CallCredentials (#10208, #10211). thisUsesUnstableApi() is @Deprecated and has a default implementation. CallCredentials implementations should delete their implementation or remove @Overrides, as the method will be deleted in the future.ProxyDetector hierarchy and ManagedChannelBuilder.proxyDetector method.TRANSIENT_FAILURE in PickFirstLoadBalancer (#10106). See gRFC A62. If it can't connect, pick-first will now immediately fail RPCs until after it successfully connects. RPCs will no longer be delayed while it performs those attempts, which previously could cause significant (error) latency. It now also performs reconnect attempts after failure and backoff without prompting; previously it required an RPC to trigger the reconnect. ManagedChannel.idleTimeout (defaults to 30 minutes) still applies and forces the channel idle after a period of no RPCs.responseObserver into the methods for initiating a call that takes a responseObserver argument. This ensures a fail fast with a clearer cause instead of an NPE when the observer is first used.GRPC_EXPERIMENTAL_XDS_RLS_LB to false.weighted_round_robin_experimental LB Policy to weighted_round_robin (#10162).PickFirstLoadBalancer (#10110).pick_first LB configuration (#10181).error-per-second in weight formula for client-side WRR (#10177). application_utilization and fallback to cpu_utilization if unset in weight formula for client-side WRR. (#10256)..aar file when publishing. (#10138).Status.fromCodeValue(). (#10155).[1.56.0] instead of 1.56.0) has been removed from POMs, for both Netty and gRPC dependencies. The pinning was unreliable in Maven and ignored in Gradle, yet caused downloads during the build to fetch the version list. For a while we've had a BOM that helps reduce version skew. (#10175).java_common. (#10225).netty-tcnative-boringssl-static in grpc-netty-shaded to 2.0.61.Final (#10260). Netty itself was not updated.proto-google-common-protos to 2.17.0 (#10178).Your coding agent can read these notes before it upgrades. Set up the MCP server →
core: Fix regression in 1.54.0 where polling NameResolvers would not refresh after a resolution error (#10328). The symptom is a transient failure lik
grpc-grpclb is in the classpath. So even users that think "I don't use grpclb" may have been impacted. round_robin is mainly impacted on startup, but if the error happened afterward it would commonly fix itself for short transient DNS failures. pick_first is impacted at all times; any failed DNS resolution could cause all future RPCs on the channel to fail.The 1.55.0 release failed. There were no artifacts published for it.
The 1.55.0 release failed. There were no artifacts published for it.
MetricRecorder.setQps/clearQps to setQpsMetric/clearQpsMetric (#10031)CallOptions.withCompression, CallOptions.getCompressor, AbstractStub.withCompression, ServerCall.setCompression, ServerCall.setMessageCompressionDetachable and HasByteBufferGcpObservability (https://github.com/grpc/grpc-java/pull/10024). The GcpObservability API provides a simple way to export logging, tracing, and metrics to Google Cloud Operations. See the Google Cloud blog post.FileWatcherAuthorizationServerInterceptor (#9775)OrcaMetricReportingServerInterceptor.create(MetricRecorder) which adds common metrics per-RPC (#9902)UdsChannelBuilder for using LocalSocket an Android (#8418)GRPC_ALTS_MAX_CONCURRENT_HANDSHAKES environment variable user to adjust the max number of concurrent ALTS handshakes (#10016)PeerUid and PeerUids (#9952)BindServiceFlags.setAllowActivityStarts() for BIND_ALLOW_ACTIVITY_STARTS added in Android U (#10008)OkHttpServerBuilder.maxConnectionAgeGrace() (#9968)java.util.NoSuchElementException: SecurityProtocolNegotiators$ClientSdsHandler#0 (#10118). This error did not cause any problems, other than unnecessary logginggoogle-c2p: resolver’s default xds bootstrap (#10121)core: Fix regression in 1.54.0 where polling NameResolvers would not refresh after a resolution error (https://github.com/grpc/grpc-java/pull/10328).
core: Fix NPE race during hedging (https://github.com/grpc/grpc-java/pull/10046), fixing a Netty buffer memory leak for cancelled RPCs
xds: Add weightedRoundRobin LB policy. The WRR policy allows picking the subchannel by weight based on the metrics feedback from the backend using ORC
AsyncService that the <service-name>ImplBase class implements. This allows you to provide your own base class when used with the static <service-name>Grpc.bindService(AsyncService) method(#9688).NameResolverProviders, however, are expected to return the scheme used for registration in lower-case@benjaminp @s-matyukevich @Faqa @antechrestos @carl-mastrangelo @ioanbsu
googleapis: Allow user set c2p bootstrap config
RouteConfiguration (#9845)grpc-previous-rpc-attempts to the initial response metadata (#9686)RejectedExecutionException. (#9754)MessageProducer in RetriableStream (#9853), fixing a Netty buffer memory leak for cancelled RPCsNullPointerException when a Metadata.Marshaller returns null bytes (#9781). This would previously cause a NullPointerException later during the RPC. Now the return value of the Marshaller is checked immediately, to help find the broken Marshaller@Generated as used by autovalue (#9762). Necessary for building xds and rls on Java 9+runtime_deps to discourage their use by Bazel users, but that could cause compilation failures from lack of hjars. These targets now use exports@cpovirk @niloc132 @stephenh @olderwei @pandaapo @panxuefeng
xds: Fix an internal bug in xds resource subscription that might cause xds stream not accepting response update for that resource type entirely.
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary h
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary had started. xDS users should avoid this release and use 1.50.x until patch releases with the fix are available. https://github.com/grpc/grpc-java/pull/9809
@Immutable (#9689)RingHashOptions.setRingSizeCap() can increase the limitBinderChannelBuilder.strictLifecycleManagement() which disables idle timeout and prevents it from being changed (#9486). Disabling idle timeout can be useful to find bugs in applications that fail to promptly shut down the channel and are particularly sensitive to keeping Binder instances alive.@RapperCL @Smityz @pandaapo
xds: Fix an internal bug in xds resource subscription that might cause xds stream not accepting response update for that resource type entirely.
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary h
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary had started. xDS users should avoid this release and use 1.50.x until patch releases with the fix are available. https://github.com/grpc/grpc-java/pull/9809
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary h
grpc-xds starting with 1.51.0 had a regression where resources might stop receiving updates. The trigger could happen hours or days after the binary had started. xDS users should avoid this release and use 1.50.x until patch releases with the fix are available. https://github.com/grpc/grpc-java/pull/9809
@TrevorEdwards
core: Free unused MessageProducer in RetriableStream (https://github.com/grpc/grpc-java/pull/9853), fixing a Netty buffer memory leak for cancelled RP
gcp-observability: Supports period(.) in the service name part of regular expression for a fully-qualified method to accept "package.service"
gcp-observability: Supports period(.) in the service name part of regular expression for a fully-qualified method to accept "package.service"
gcp-observability: support new configuration defined in grpc-gcp-observability public preview user guide
gcp-observability: support new configuration defined in grpc-gcp-observability public preview user guide
okhttp: Added connection management features to okhttp server, including maxConnectionIdle(), permitKeepAliveTime(), and permitKeepAliveWithoutCalls()
SecurityPolicies for checking device owner/profile owner (#9428)handleResolvedAddresses() but returns a boolean of whether the addresses and configuration were accepted. Not accepting the update triggers the NameResolver to retry after a delay. We are not yet encouraging migration to this method, as there is still a second future API change@cpovirk @prateek-0 @sai-sunder-s
## Dependencies - Bump protobuf to 3.21.7
xds: Fix a bug in ring-hash load balancing policy that, during TRANSIENT_FAILURE state, it might cause unnecessary internal connection requests on sub
TRANSIENT_FAILURE state, it might cause unnecessary internal connection requests on subchannels. (#9537)okhttp: Add OkHttpServerBuilder. The server can be used directly, but is not yet available via ServerBuilder.forPort() and Grpc.newServerBuilderForPor
OkHttpServerBuilder. The server can be used directly, but is not yet available via ServerBuilder.forPort() and Grpc.newServerBuilderForPort(). It passes our tests, but has seen no real-world use. It is also lacking connection management featuresno such target '@io_grpc_grpc_java//services:services' for services and missing ORCA classes for xds. The wrong target names were introduced in 1.47.0@benjaminp @j-min5u
xds: Fix a bug in ring-hash load balancing policy that, during TRANSIENT_FAILURE state, it might cause unnecessary internal connection requests on sub
ORCA provides APIs to inject custom metrics at a gRPC server, and consume them at a gRPC client. It implements A51: Custom Backend Metrics Support. We
ORCA provides APIs to inject custom metrics at a gRPC server, and consume them at a gRPC client. It implements A51: Custom Backend Metrics Support. We changed the ORCA APIs; they had broken shading and couldn't really be used, so we fixed them in the patch release.
INTERNAL, desc: Half-closed without a request at server call. (#9362)Removed the Class-Path manifest entry from jars generated with the gradle shadow plugin (#9270). This should prevent “[WARNING] [path] bad path elemen
Attributes.Keys to reference the API of the key. This should make it easier to find the API the key is exposed when using attributes.toString()Attributes.Key uses reference equality. This is to make it clear the behavior is on purpose, and mirrors other Key types in the APIEquivalentAddressGroup.ATTR_AUTHORITY_OVERRIDE, to avoid misuse by NameResolvers (#9281)GrpcCleanupRule now extends ExternalResource. This makes it usable with JUnit 5com.google.api.grpc:proto-google-common-protos to 2.9.0@mirlord @zhangwenlong8911 @adilansari @amirhadadi @jader-eero @jvolkman @sumitd2
core: Fix retry causing memory leak for canceled RPCs.
OnNotServing on StatusListener when the delegated server initial start fails. (#9276, #9279)Bump GSON to 2.9.0. Earlier versions of GSON are affected by CVE-2022-25647. gRPC was not impacted by the vulnerability.
ClassCastExceptions for hard-coded providers on Android (#9174). This avoids ServiceConfigurationError in certain cases when an “SDK” includes a copy of gRPC that was renamed with Proguard-like tools that do precise class name rewriting (versus something like Maven Shade Plugin which uses coarse pattern matching)asAndroidAppUri() (#9169)ScheduledExecutorService for keepalive if provided. Previously the user-provided executor was used for deadlines, but not keepalive. Keepalive always used the default executor (#9073)libgrpclb.jar produced by bazel //grpclb:grpclb target (#9156)TRANSIENT_FAILURE status. (#9085)ServerBuilder (#9176). This includes methods for keepalive, max connection age, and max connection idle. These APIs have been available on NettyServerBuilder since v1.4.0NameResolver to influence which transport to use (#9076)NameResolver for unix: scheme, as defined in gRPC Name Resolution (#9113)allOf security policy, which allows access iff ALL given security policies allow access. (#9125)anyOf security policy, which allows access if ANY given security policy allows access. (#9147)hasPermissions security policy, which checks that a caller has all of the given package permissions. (#9117)IO_GRPC_GRPC_JAVA_OVERRIDE_TARGETS so maven_install will not use the artifacts from Maven Central (#9172)Cluster.load_balancing_policy field. This implements gRFC A52: gRPC xDS Custom Load Balancer Configuration. (#9141)is_optional logic in Cluster Specifier Plugins: if an unsupported Cluster Specifier Plugin is optional, don't NACK, and skip any routes that point to it. (#9168)ring_hash LB aggregation rule to better handle transient_failure channel status (#9084, #9093)@caseyduquettesc @cfredri4 @jvolkman @mirlord @ovidiutirla
xds: Remove permanent error handling in LDS update in XdsServerWrapper. Also notify OnNotServing on StatusListener when the delegated server initial s
OnNotServing on StatusListener when the delegated server initial start fails. (#9278, #9280)netty: Fixed incompatibility with Netty 4.1.75.Final that caused COMPRESSION_ERROR
xds.config.resource-in-sotw client capability. Resources wrapped in a io.envoyproxy.envoy.service.discovery.v3.Resource message are now supported (#8997)@jesseschalken @kluever @beatrausch
core: Free unused MessageProducer in RetriableStream (https://github.com/grpc/grpc-java/pull/9853), fixing a memory leak for cancelled RPCs
core: Fix retry causing memory leak for canceled RPCs.
xds: fix bugs in ring-hash load balancer picking subchannel behavior per gRFC. The bug may cause connection not failing over from TRANSIENT_FAILURE st
TRANSIENT_FAILURE status. (#9085)ring_hash LB aggregation rule to better handle transient_failure channel status (#9084)netty: Fixed incompatibility with Netty 4.1.75.Final that caused COMPRESSION_ERROR
rls: fix child lb leak when client channel is shutdown
netty: Fixed incompatibility with Netty 4.1.75.Final that caused COMPRESSION_ERROR
TRANSIENT_FAILURE status. (#9085)ring_hash LB aggregation rule to better handle transient_failure channel status (#9084)xds: fix the validation code to accept new-style CertificateProviderPluginInstance wherever used (#8901 fixes #8885)
Upgraded Protobuf to 3.19.2 to avoid CVE-2021-22569. See the protobuf advisory
Java 7 is no longer supported. This release uses Java 8 bytecode, except for grpc-context which remains on Java 7 bytecode. Users requiring Java 7 are encouraged to use the v1.41.x branch. See gRFC P5. Android support remains API level 19+. If this is expected to cause undue hardship or community issues, please contact us via a GitHub issue or grpc-io@googlegroups.com.
Java 8 users pay note: per gRFC P5, gRPC may drop Java 8 support as soon as March this year. If this is expected to cause undue hardship or community issues, please contact us via a GitHub issue or grpc-io@googlegroups.com.
ring_hash LB Policy to ring_hash_experimental to comply with gRPC A42: xDS Ring Hash LB Policy (#8776)android: fix for app coming to foreground #8850
Upgraded Protobuf to 3.19.2 to avoid CVE-2021-22569. See the protobuf advisory
core: fix a race condition when calling ManagedChannel#enterIdle()
alts: Make GoogleDefaultChannelCredentials take a CallCredentials
recordFinishedAttempt(). Users not enabling grpc-census are not impacted by this bug (#8706)-Dio.grpc.netty.disableConnectionHeaderCheck=false to disable HTTP Connection header check. This is a temporary workaround to allow fixing out-of-spec HTTP/2 clients (#8683)@beatrausch @benjaminp Benjamin Peterson @cfredri4 @kdubb Kevin Wooten
## Dependencies - Bump protobuf to 3.19.6
Upgraded Protobuf to 3.18.2 to avoid CVE-2021-22569. See the protobuf advisory
recordFinishedAttempt(). Users not enabling grpc-census are not impacted by this bug (#8706)ManagedChannel.enterIdle() (#8746)xds: fix a bug that invalid resources from the control plane was internally classified as missing configuration, but instead it should be classified a
Bug fixes:
XdsServer from noticing when a control plane sent a needless duplicate update, causing XdsServer to drain all its existing connections to use the “new” configuration #8688New feature:
-Dio.grpc.netty.disableConnectionHeaderCheck=false to disable HTTP Connection header check. This is a temporary workaround to allow fixing out-of-spec HTTP/2 clients #8683In this release we drop support for Android API level 18 or lower (Jelly Bean or earlier), following Google Play Service’s discontinued updates for Je
In this release we drop support for Android API level 18 or lower (Jelly Bean or earlier), following Google Play Service’s discontinued updates for Jelly Bean (API levels 16, 17 & 18).
XdsServerBuilder.overrideBootstrapForTest() to provide bootstrap override for testing purposes. This way, the test does not need to use the shared environment variable for bootstrap injection. (#8575)Status.asException(Metadata) method. (#8520)CallCredentials2 (#8572). CallCredentials2 was introduced in 1.16.0 to ease migration of CallCredentials to an abstract class. CallCredentials has been preferred over CallCredentials2 since 1.19.0ServerCallStreamObserver.setOnCloseHandler(Runnable). Notified when gRPC has completed processing the RPC. (#8452)4.1.63.Final and tcnative to 2.0.38.Final. (#8167)io.grpc.util.AdvancedTlsX509KeyManager and AdvancedTlsX509TrustManager support loading configuration from static files. (#8525)io.grpc.util.CertificateUtils.getPrivateKey() now supports RSA and EC key algorithmsOne column per quarter.