如何在代码优先模式下实现gRPC版本控制？

在代码优先模式中，我们可以通过以下几种方式实现类似proto文件中package的版本控制效果：

1. 用命名空间隔离版本 #

直接通过C#命名空间划分不同版本的服务和消息类型，这和proto里package的核心作用一致：

• 定义v1版本的服务与消息：

namespace MyApp.Grpc.V1;

public class ProductRequest
{
    public int Id { get; set; }
}

[GrpcService]
public class ProductServiceV1 : ProductService.ProductServiceBase
{
    public override Task<ProductResponse> GetProduct(ProductRequest request, ServerCallContext context)
    {
        // v1版本业务逻辑实现
    }
}

• 定义v2版本的服务与消息：

namespace MyApp.Grpc.V2;

public class ProductRequest
{
    public int Id { get; set; }
    public bool IncludeDetails { get; set; } // v2新增字段
}

[GrpcService]
public class ProductServiceV2 : ProductService.ProductServiceBase
{
    public override Task<ProductResponse> GetProduct(ProductRequest request, ServerCallContext context)
    {
        // v2版本业务逻辑实现
    }
}

2. 配置服务端点路径 #

为不同版本的服务指定专属路径前缀，让客户端通过路径区分版本，和proto中package生成的路径结构对齐：
在Program.cs中配置：

builder.Services.AddGrpc();

var app = builder.Build();

// 给v1服务设置路径前缀
app.MapGrpcService<ProductServiceV1>()
    .WithMetadata(new Metadata { { "grpc-path-prefix", "/myapp.grpc.v1" } });

// 给v2服务设置路径前缀
app.MapGrpcService<ProductServiceV2>()
    .WithMetadata(new Metadata { { "grpc-path-prefix", "/myapp.grpc.v2" } });

配置后，v1服务的调用路径为/myapp.grpc.v1.ProductService/GetProduct，v2则为/myapp.grpc.v2.ProductService/GetProduct，实现版本的路径隔离。

3. 结合路由特性精细化控制 #

可以通过ASP.NET Core的路由特性，直接为服务添加版本路由标识：

[GrpcService]
[Route("v1/[service]")]
public class ProductServiceV1 : ProductService.ProductServiceBase
{
    // ...
}

[GrpcService]
[Route("v2/[service]")]
public class ProductServiceV2 : ProductService.ProductServiceBase
{
    // ...
}

这种方式同样能实现不同版本服务的访问路径区分。

核心要点 #

• 命名空间是基础，用来隔离不同版本的类型，避免冲突；
• 路径配置是补充，让客户端能精准定位到对应版本的服务；
• 整体效果和proto文件中package的版本控制逻辑完全匹配。

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