gRPC中API如何实现？多服务是否需开启新端口？

核心结论 #

不需要为每个gRPC服务单独启动新服务器或占用新端口，同一个gRPC服务器实例可以注册多个不同的服务，所有服务共享同一个监听端口。

gRPC的路由与API实现原理 #

gRPC的路由和API匹配依赖以下核心机制：

1. Protobuf服务定义：所有gRPC服务和方法都通过.proto文件声明，每个服务有唯一的服务标识（格式通常是包名.服务名），每个方法隶属于对应服务。
2. HTTP/2路径路由：gRPC基于HTTP/2传输，客户端请求的:path头部会携带目标服务和方法的完整标识，格式为/package_name.ServiceName/MethodName。
3. 服务注册与分发：服务器启动时，将多个服务的实现实例注册到同一个grpc.Server中，服务器收到请求后，通过解析:path字段匹配到对应的服务和方法，自动将请求转发到对应的处理函数。

代码示例：单端口承载多服务 #

基于你的现有代码，只需新增另一个服务的实现并注册到同一个服务器即可：

1. 新增Protobuf服务定义（示例） #

假设你有另一个.proto文件定义了书评服务：

syntax = "proto3";

package book;

service BookReviewService {
  rpc GetReview (ReviewRequest) returns (ReviewResponse);
}

message ReviewRequest {
  int32 book_id = 1;
}

message ReviewResponse {
  string review_text = 1;
  int32 rating = 2;
}

2. 实现新增服务的处理逻辑 #

type bookReviewServer struct {
    pb.UnimplementedBookReviewServer
}

// GetReview 处理书评查询请求
func (s *bookReviewServer) GetReview(ctx context.Context, req *pb.ReviewRequest) (*pb.ReviewResponse, error) {
    // 替换为你的书评业务逻辑
    return &pb.ReviewResponse{
        ReviewText: "这本小说情节紧凑，值得一读",
        Rating: 4,
    }, nil
}

3. 注册多个服务到同一服务器 #

修改你的SomeAction函数，同时注册两个服务：

func SomeAction() {
    lis, err := net.Listen("tcp", "mcrsrv-book:7561")
    if err != nil {
        log.Fatalf("failed to listen: %v", err)
    }
    grpcServer := grpc.NewServer()
    
    // 注册书籍查询服务
    pb.RegisterRouteGuideServer(grpcServer, newServer())
    // 注册书评服务
    pb.RegisterBookReviewServer(grpcServer, &bookReviewServer{})
    
    grpcServer.Serve(lis)
}

关键细节说明 #

• 服务接口实现：每个gRPC服务都需要实现Protobuf生成的服务接口（继承UnimplementedXXXServer是为了兼容未来新增方法，避免代码报错）。
• 请求分发：服务器会自动处理路由匹配，无需手动编写路由规则，开发者只需专注于业务逻辑实现。
• 扩展性：后续新增其他gRPC服务，只需重复「定义Protobuf → 实现接口 → 注册到服务器」的流程即可，无需修改端口或启动新服务器。

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