NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central, #728 by repository stars
gRPC: googleapis
Latest stable
1.85.1
Last release 25 days 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
91 releases · first in 2022
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
One column per quarter.