如何将现有Spring Gateway与Eureka服务配置为支持Spring gRPC？

1. 添加依赖 #

先给各服务引入对应依赖，确保版本和你的Spring Boot/Spring Cloud版本兼容：

gRPC服务端依赖（Maven）

<dependencies>
    <!-- gRPC核心依赖 -->
    <dependency>
        <groupId>net.devh</groupId>
        <artifactId>grpc-spring-boot-starter</artifactId>
        <version>2.15.0.RELEASE</version> <!-- 匹配你的Spring Boot版本 -->
    </dependency>
    <!-- Eureka客户端依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
</dependencies>

Spring Gateway依赖（Maven）

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
    <!-- gRPC网关扩展 -->
    <dependency>
        <groupId>net.devh</groupId>
        <artifactId>grpc-spring-cloud-gateway-starter</artifactId>
        <version>2.15.0.RELEASE</version>
    </dependency>
    <!-- Eureka客户端依赖，用于发现gRPC服务 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
</dependencies>

Eureka Server依赖（自行搭建时）

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
</dependencies>

2. 配置gRPC服务注册到Eureka #

在gRPC服务的application.yml中，除常规Eureka注册配置，需添加gRPC端口元数据，让Gateway识别通信端口：

server:
  port: 8080 # 可选REST端口（如果服务同时提供REST接口）
grpc:
  server:
    port: 8090 # gRPC服务专属端口
eureka:
  client:
    service-url:
      defaultZone: http://your-eureka-server:8761/eureka/
  instance:
    metadata-map:
      grpc.port: ${grpc.server.port} # 将gRPC端口存入Eureka元数据

同时在gRPC服务启动类添加注解：

@SpringBootApplication
@EnableEurekaClient
@EnableGrpcServer
public class GrpcServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(GrpcServiceApplication.class, args);
    }
}

3. 配置Spring Gateway转发gRPC请求 #

在Gateway的application.yml中，配置基于Eureka服务发现的gRPC路由规则：

server:
  port: 9000 # Gateway对外端口
eureka:
  client:
    service-url:
      defaultZone: http://your-eureka-server:8761/eureka/
spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true # 启用服务发现自动路由
          lower-case-service-id: true
      routes:
        - id: grpc-service-route
          uri: lb://your-grpc-service-id # Eureka中注册的gRPC服务ID
          predicates:
            - Path=/your.package.name.GrpcService/** # 匹配gRPC服务的全限定名路径
          filters:
            - GrpcRequestHeader=X-Forwarded-For, {remoteAddr} # 可选：添加转发请求头

4. 关键注意事项 #

• 版本兼容：确保grpc-spring-boot-starter和grpc-spring-cloud-gateway-starter的版本与Spring Boot版本匹配（比如Spring Boot 2.7.x对应grpc-starter 2.15.x系列）
• gRPC路径匹配：路由中的Path需对应proto文件中定义的服务全限定名（例如proto中package com.example; service UserService，路径为/com.example.UserService/**）
• 端口隔离：避免gRPC端口、REST端口、Gateway端口互相占用
• 元数据必填：gRPC服务必须在Eureka元数据中声明grpc.port，否则Gateway无法定位正确的gRPC通信端口

内容的提问来源于stack exchange，提问作者OmniCoder77