Blazor WASM托管方案集成测试可行性咨询

1. 完全可以直接测试Web API #

你的服务器项目本质是ASP.NET Core Web应用，完全可以用ASP.NET Core官方的WebApplicationFactory进行集成测试，哪怕涉及Identity Server认证和BFF逻辑。

核心思路： #

• 用WebApplicationFactory启动你的服务器项目，创建测试HTTP客户端
• 针对需要认证的API，在测试中模拟已认证的用户上下文：
  • 可以利用Identity Server的测试扩展生成有效JWT令牌，附加到请求头
  • 或者直接在测试客户端的请求中手动设置认证凭证，比如通过自定义认证处理器模拟用户身份

简单示例代码： #

public class ApiIntegrationTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly WebApplicationFactory<Program> _factory;

    public ApiIntegrationTests(WebApplicationFactory<Program> factory)
    {
        _factory = factory.WithWebHostBuilder(builder =>
        {
            builder.ConfigureServices(services =>
            {
                // 配置测试用认证方案
                services.AddAuthentication("TestAuth")
                    .AddScheme<AuthenticationSchemeOptions, TestAuthHandler>("TestAuth", _ => { });
            });
        });
    }

    [Fact]
    public async Task AuthenticatedApi_ShouldReturnSuccess()
    {
        var client = _factory.CreateClient();
        // 添加测试认证头
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("TestAuth");

        var response = await client.GetAsync("/api/your-protected-endpoint");
        response.EnsureSuccessStatusCode();
    }

    // 自定义测试认证处理器，模拟已登录用户
    private class TestAuthHandler : AuthenticationHandler<AuthenticationSchemeOptions>
    {
        protected override Task<AuthenticateResult> HandleAuthenticateAsync()
        {
            var claims = new List<Claim>
            {
                new Claim(ClaimTypes.Name, "test-user"),
                new Claim(ClaimTypes.Role, "admin")
            };
            var identity = new ClaimsIdentity(claims, Scheme.Name);
            var principal = new ClaimsPrincipal(identity);
            var ticket = new AuthenticationTicket(principal, Scheme.Name);

            return Task.FromResult(AuthenticateResult.Success(ticket));
        }
    }
}

2. 单独测试xxxService验证gRPC连接与响应也可行 #

xxxService作为gRPC调用的封装层，本身具备可测试性，你可以根据需求选择两种测试方式：

方式一：集成测试（验证真实gRPC服务交互） #

• 直接实例化xxxService，注入指向测试环境的真实gRPC客户端
• 调用xxxService的方法，断言返回结果符合预期，以此验证gRPC连接和响应逻辑

方式二：模拟gRPC服务（隔离外部依赖） #

如果不想依赖真实gRPC服务，可以用Grpc.AspNetCore.Testing包搭建模拟gRPC服务器，让xxxService连接到模拟服务验证逻辑：

[Fact]
public async Task XxxService_GrpcCall_ShouldReturnExpectedResponse()
{
    // 创建模拟gRPC服务器
    var server = new GrpcTestServer(services =>
    {
        services.AddGrpc();
        services.AddSingleton<YourGrpcService.YourGrpcServiceBase>(new MockGrpcService());
    });

    // 创建连接到模拟服务器的gRPC客户端
    var channel = server.CreateChannel();
    var grpcClient = new YourGrpcClient(channel);

    // 实例化xxxService并注入gRPC客户端
    var xxxService = new XxxService(grpcClient);

    // 调用方法并验证结果
    var result = await xxxService.CallTargetGrpcMethodAsync();
    Assert.NotNull(result);
    Assert.Equal("expected-content", result.TargetProperty);
}

// 模拟的gRPC服务实现
public class MockGrpcService : YourGrpcService.YourGrpcServiceBase
{
    public override Task<YourGrpcResponse> TargetGrpcMethod(YourGrpcRequest request, ServerCallContext context)
    {
        return Task.FromResult(new YourGrpcResponse { TargetProperty = "expected-content" });
    }
}

总结 #

两种方案各有侧重：

• 测试Web API能覆盖从HTTP请求到gRPC转发的完整业务流程，更贴近真实用户场景
• 测试xxxService则聚焦于gRPC交互逻辑，适合快速验证封装层的正确性，也能在外部服务未就绪时开展测试

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