ASP.NET Core 5.0 托管gRPC与REST控制器时带参路由访问异常

你遇到的是ASP.NET Core 5.0 版本下gRPC端点与REST控制器的路由优先级冲突问题，具体触发逻辑如下：

• MapGrpcService<TestProviderService>() 默认生成的gRPC端点，在5.0版本中没有显式添加仅接受POST请求的HTTP方法约束，会无差别匹配同结构的任意HTTP方法路径。
• 你访问的/values/123、/values/1234/2345 这类两段结构的GET请求，会被gRPC的通配路径端点优先捕获。因请求不符合gRPC的POST协议要求，系统直接返回404，并不会将请求转发给对应的REST控制器。
• 你之前配置的Kestrel多协议支持逻辑本身没有错误，该配置没有生效的原因是：路由匹配环节早于协议判定、内容类型校验环节，请求早在路由阶段就被错误拦截，根本走不到协议适配的逻辑。

方案1：为gRPC端点补充HTTP方法约束（改动最小，推荐优先使用） #

在注册gRPC端点时，显式为其添加仅接受POST请求的元数据，让它不再拦截GET类的REST请求。
修改后的端点注册代码如下：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();

    // 原有gRPC注册逻辑，补充HTTP方法约束
    endpoints.MapGrpcService<TestProviderService>()
        .WithMetadata(new HttpMethodMetadata(new[] { "POST" }));

    endpoints.MapGet("/", async context =>
    {
        context.Response.Redirect("/docs/index.html");
    });
});

修改后gRPC端点仅会拦截符合要求的POST类gRPC请求，所有GET请求会正常按照路由规则匹配到REST控制器，无需调整原有路由结构。

方案2：为REST控制器路由提升匹配优先级 #

如果部分REST接口使用POST方法，存在和gRPC路径结构重叠的可能，可以通过给REST路由添加参数格式约束、调整路由优先级的方式，确保REST路由优先匹配：

• 为控制器上的路由标记指定Order值（值越小优先级越高）
• 为路径中的ID参数添加类型约束（适配你实际使用的GUID格式参数）

示例的控制器代码如下：

[Route("[controller]")]
public class ValuesController : ControllerBase
{
    // 无参GET接口
    [HttpGet(Order = int.MinValue)]
    public IActionResult Get() => Ok(new { });

    // 带单个GUID参数的GET接口
    [HttpGet("{id:guid}", Order = int.MinValue)]
    public IActionResult GetById(Guid id) => Ok(new { id });

    // 带两个GUID参数的GET接口
    [HttpGet("{id1:guid}/{id2:guid}", Order = int.MinValue)]
    public IActionResult GetByTwoId(Guid id1, Guid id2) => Ok(new { id1, id2 });
}

方案3：通过路径前缀隔离gRPC与REST的路由空间 #

如果需要从根源上避免路径重叠，可以给所有gRPC接口统一增加/grpc固定前缀，让两类服务的路径结构完全独立：

• 在注册gRPC端点时添加拦截逻辑，仅处理/grpc前缀下的请求，自动剥离前缀后再走gRPC内部路由
• 保留原有REST控制器的路由规则不做调整

配置示例如下：

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();

    endpoints.MapGrpcService<TestProviderService>()
        .AddEndpointFilter(async (invocationContext, next) =>
        {
            var requestPath = invocationContext.HttpContext.Request.Path;
            // 非/grpc前缀的请求直接跳过gRPC处理流程
            if (!requestPath.StartsWithSegments("/grpc"))
            {
                return next(invocationContext);
            }
            // 剥离路径前缀，适配gRPC内部的路由规则
            invocationContext.HttpContext.Request.Path = requestPath.Value!.Replace("/grpc", "");
            return await next(invocationContext);
        })
        .WithMetadata(new HttpMethodMetadata(new[] { "POST" }));

    endpoints.MapGet("/", async context =>
    {
        context.Response.Redirect("/docs/index.html");
    });
});

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