Skip to content

docs: Add required dependencies for JsonToGrpc filter#4117

Open
Tarte12 wants to merge 1 commit intospring-cloud:mainfrom
Tarte12:docs/jsontogrpc-required-dependencies
Open

docs: Add required dependencies for JsonToGrpc filter#4117
Tarte12 wants to merge 1 commit intospring-cloud:mainfrom
Tarte12:docs/jsontogrpc-required-dependencies

Conversation

@Tarte12
Copy link
Copy Markdown
Contributor

@Tarte12 Tarte12 commented Mar 28, 2026

Problem

When using the JsonToGrpc GatewayFilter, users encounter a NoClassDefFoundError at runtime because the required dependencies are not included transitively (they are declared as optional in spring-cloud-gateway-server-webflux). This was not documented anywhere.

Closes #3424

Solution

Added a Required Dependencies section to the JsonToGrpc filter documentation listing the four dependencies that must be explicitly added:

  • io.grpc:grpc-netty
  • io.grpc:grpc-protobuf
  • io.grpc:grpc-stub
  • com.google.protobuf:protobuf-java-util

The JsonToGrpc GatewayFilter relies on several optional dependencies
that are not included transitively. Without them, users encounter a
NoClassDefFoundError at runtime when the filter is invoked.

Documented required dependencies:
- io.grpc:grpc-netty
- io.grpc:grpc-protobuf
- io.grpc:grpc-stub
- com.google.protobuf:protobuf-java-util

Fixes spring-cloudgh-3424

Signed-off-by: Tarte <emprimula@gmail.com>
@CheHyeonYeong

This comment has been minimized.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document required dependencies for JsonToGrpc Filter

3 participants