gRPC-Web是为浏览器设计的gRPC变体,通过HTTP/1.1封装调用,需在.NET中启用gRPC-Web中间件、生成前端stub并配置CORS,支持一元和客户端流式调用。

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-Web 不是直接运行在 HTTP/2 上,而是通过代理转换请求 需要后端部署一个 gRPC-Web 兼容的代理或启用支持中间件 前端使用生成的客户端 stub 调用服务,就像调用普通 API 一样
如何让浏览器应用调用 gRPC 服务?
要在 .NET 环境中实现浏览器调用 gRPC 服务,需完成以下步骤:
1. 在服务端启用 gRPC-Web 支持
如果你使用的是 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();app.Run();
这样,gRPC 服务就可以接受来自浏览器的 gRPC-Web 请求了。
2. 前端使用 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 和消息类文件。
3. 在前端代码中调用服务
示例(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 服务地址。
4. 处理跨域问题(CORS)
如果前端和 gRPC 服务不在同一域名下,需要配置 CORS:
builder.Services.AddCors(options =>{ options.AddPolicy("AllowAll", policy => { policy.AllowAnyOrigin() .AllowAnyHeader() .AllowAnyMethod(); });});// 在 UseRouting 之后启用 CORSapp.UseCors("AllowAll");
总结
gRPC-Web 让浏览器可以直接调用后端 gRPC 服务,提升了前后端通信效率和类型安全性。在 .NET 中,只需启用 gRPC-Web 中间件,配合前端生成的客户端代码,即可实现高性能、强类型的 API 调用。虽然不支持所有流式场景,但对于大多数 Web 应用的一元调用已完全够用。
基本上就这些,不复杂但容易忽略中间件顺序和 CORS 配置。
以上就是.NET中的gRPC-Web是什么?如何让浏览器应用调用gRPC服务?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1441877.html
微信扫一扫
支付宝扫一扫