.NET中的gRPC-Web是什么？如何让浏览器应用调用gRPC服务？

gRPC-Web 是 gRPC 的一种变体，专为浏览器环境设计。标准的 gRPC 使用 HTTP/2 的双向流和多路复用特性，但大多数浏览器不支持直接使用 HTTP/2 发起 gRPC 调用，因此无法在前端 JavaScript 中直接调用原生 gRPC 服务。gRPC-Web 就是为了解决这个问题而诞生的。

什么是 gRPC-Web？

gRPC-Web 是一个允许浏览器应用通过 JavaScript 或 TypeScript 调用 gRPC 服务的协议。它在客户端使用普通的 HTTP 请求（通常是 HTTP/1.1），将 gRPC 调用封装成兼容 Web 的格式。由于浏览器安全策略和网络栈的限制，gRPC-Web 并不支持所有 gRPC 功能，比如服务器流式响应在某些模式下受限，但支持一元调用（unary call）和客户端流。

关键点：

如何让浏览器应用调用 gRPC 服务？

要在 .NET 环境中实现浏览器调用 gRPC 服务，需完成以下步骤：

如果你使用的是 ASP.NET Core gRPC 服务，可以通过添加中间件来支持 gRPC-Web。从 .NET 5 开始，官方提供了对 gRPC-Web 的支持。

在 Program.cs 中配置：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddGrpc();
var app = builder.Build();
app.UseRouting();
// 启用 gRPC-Web 中间件
app.UseGrpcWeb(new GrpcWebOptions { DefaultEnabled = true });
// 映射你的 gRPC 服务
app.MapGrpcService<YourGrpcService>();
app.Run();

这样，gRPC 服务就可以接受来自浏览器的 gRPC-Web 请求了。

在浏览器端，不能使用原生 gRPC 客户端，必须使用 gRPC-Web 提供的 JavaScript 客户端。推荐使用 grpc-web npm 包。

安装：

npm install grpc-web google-protobuf

然后使用 protoc 和插件生成前端可用的客户端代码：

protoc --js_out=import_style=commonjs,binary:. \
       --grpc-web_out=import_style=commonjs,mode=grpcwebtext:. \
       your_service.proto

这会生成

YourServiceClient.js

示例（TypeScript 或 JavaScript）：

import { YourServiceClient } from './generated/YourServiceClient';
import { YourRequest } from './generated/YourRequest';
import { YourResponse } from './generated/YourResponse';
const client = new YourServiceClient('https://localhost:7001');
const request = new YourRequest();
request.setName('Alice');
client.yourMethod(request, {}, (err, response: YourResponse) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log(response.getMessage());
});

注意：URL 指向的是启用 gRPC-Web 的 ASP.NET Core 服务地址。

如果前端和 gRPC 服务不在同一域名下，需要配置 CORS：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowAll", policy =>
    {
        policy.AllowAnyOrigin()
              .AllowAnyHeader()
              .AllowAnyMethod();
    });
});
// 在 UseRouting 之后启用 CORS
app.UseCors("AllowAll");

总结

gRPC-Web 让浏览器可以直接调用后端 gRPC 服务，提升了前后端通信效率和类型安全性。在 .NET 中，只需启用 gRPC-Web 中间件，配合前端生成的客户端代码，即可实现高性能、强类型的 API 调用。虽然不支持所有流式场景，但对于大多数 Web 应用的一元调用已完全够用。

基本上就这些，不复杂但容易忽略中间件顺序和 CORS 配置。