如何构造含测试用户的ProtoBuf.Grpc CallContext用于gRPC方法单元测试？

核心思路 #

要构造包含预定义用户的CallContext，关键是让ServerCallContext关联一个带有测试用户ClaimsPrincipal的HttpContext；而CallContext构造函数中的server参数在测试场景下可以直接传null——该参数仅在服务端内部依赖完整服务实例时才会用到，单元测试中无需实际服务实例，传空值不影响功能。

完整代码示例 #

先引用必要的命名空间：

using Grpc.Core;
using Grpc.Core.Testing;
using Microsoft.AspNetCore.Http;
using System.Security.Claims;
using System.IdentityModel.Tokens.Jwt;
using ProtoBuf.Grpc;

编写测试方法：

[Fact]
public async Task MyMethod_WithTestUser_ReturnsExpectedResponse()
{
    // 1. 创建预定义的测试用户ClaimsPrincipal
    var testClaims = new List<Claim>
    {
        new Claim(JwtRegisteredClaimNames.Name, "test_user_001"),
        // 可按需添加其他Claim，比如角色、用户ID等
        new Claim(ClaimTypes.Role, "Admin")
    };
    var testUser = new ClaimsPrincipal(new ClaimsIdentity(testClaims, "TestAuth"));

    // 2. 构造测试用HttpContext并关联用户
    var httpContext = new DefaultHttpContext();
    httpContext.User = testUser;

    // 3. 创建TestServerCallContext并关联HttpContext
    var serverCallContext = TestServerCallContext.Create(
        method: null, // 测试中无需实际方法定义，传null即可
        host: "test-host",
        deadline: DateTime.UtcNow.AddSeconds(30),
        requestHeaders: new Metadata(),
        cancellationToken: CancellationToken.None,
        peer: "test-peer",
        authContext: null,
        contextPropagationToken: null,
        httpContext: httpContext // 关键：传入带测试用户的HttpContext
    );

    // 4. 构造CallContext实例，server参数传null
    var callContext = new CallContext(null, serverCallContext);

    // 5. 实例化服务实现并调用方法
    var service = new YourGrpcServiceImplementation();
    var response = await service.MyMethod(new Request(), callContext);

    // 6. 断言验证结果
    var retrievedUserName = httpContext.User.Claims.FirstOrDefault(c => c.Type == JwtRegisteredClaimNames.Name)?.Value;
    Assert.Equal("test_user_001", retrievedUserName);
    // 其他业务逻辑断言...
}

关键说明 #

• TestServerCallContext.Create的非核心参数：除httpContext外，method、host等参数都可以传默认值或null，测试场景下不会依赖这些信息。
• 自定义授权场景：可以根据测试需求添加任意类型的Claim，模拟不同用户角色、权限的调用场景。

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