tRPC-Go 框架 01：tRPC-Go 总览与核心架构

tRPC-Go 框架 01：tRPC-Go 总览与核心架构

tRPC 是腾讯开源的多语言 RPC 框架，tRPC-Go是其 Go 语言实现，已在腾讯内部支撑了海量服务（视频、音乐、新闻、广告等），日均调用量万亿级。本篇我们站高一点，俯瞰 tRPC-Go 的整体架构与设计理念。

一、tRPC 是什么？

tRPC =tencentRPCFramework

它是一个：

• 多语言：Go / C++ / Java / Python / Node.js / Rust …
• 多协议：原生 trpc / gRPC / HTTP / 自定义
• 可插拔：服务治理、配置、可观测皆为插件
• 云原生：与 Kubernetes、Polaris 深度集成

官方仓库：https://github.com/trpc-group/trpc-go

二、为什么需要又一个 RPC 框架？

业界已有 gRPC、Dubbo，为什么腾讯还要做 tRPC？

核心动因：在腾讯内部多语言、多协议、多基础设施环境下，需要一个统一、灵活、易扩展的 RPC 框架。

三、设计理念

3.1 一切皆插件

tRPC-Go 的核心非常薄，所有能力（编解码、传输、注册中心、负载均衡、限流、日志、监控）都通过插件接口实现：

typePlugininterface{Type()stringSetup(namestring,decoder Decoder)error}

这意味着切换注册中心、加监控点、改协议只需改配置或加一行 import，业务代码零侵入。

3.2 接口定义先行

tRPC 强制以.proto为接口契约，通过trpc-cmdline工具生成桩代码：

trpc create-phello.proto-o.

生成的代码包含：

• 服务端接口（你来实现）；
• 客户端 stub（直接调用）；
• mock（测试用）。

3.3 配置驱动

所有运行时行为通过trpc_go.yaml配置：

server:service:-name:trpc.app.server.Greeterip:127.0.0.1port:8000protocol:trpcclient:service:-name:trpc.app.user.Usertarget:polaris://trpc.app.user.Userprotocol:trpctimeout:1000plugins:log:default:...registry:polaris:...

四、整体架构图

┌─────────────────────────────────────────────────────────┐ │ 业务代码 (handler) │ └─────────────────────────────────────────────────────────┘ ▲ ▲ │ 服务端 │ 客户端 ┌───────────┴──────────────┐ ┌──────────────┴──────────┐ │ Filter Chain (拦截器) │ │ Filter Chain (拦截器) │ └───────────┬──────────────┘ └──────────────┬──────────┘ ▼ ▼ ┌──────────────────────────┐ ┌─────────────────────────┐ │ Codec（编解码） │ │ Codec（编解码） │ └───────────┬──────────────┘ └──────────────┬──────────┘ ▼ ▼ ┌──────────────────────────┐ ┌─────────────────────────┐ │ Transport（传输层） │ │ Transport（传输层） │ └───────────┬──────────────┘ └──────────────┬──────────┘ └─────────── Network ────────────┘ ┌─────────────────┐ │ 插件层（贯穿全局） │ │ 注册中心 / LB │ │ 监控 / 日志 │ │ 配置中心 / 限流 │ └─────────────────┘

五、核心组件详解

5.1 Service / Server / Client

• Server：进程级别，可以承载多个 Service；
• Service：一个 RPC 服务（一组方法）；
• Client：调用端代理。

// Server 启动s:=trpc.NewServer()pb.RegisterGreeterService(s,&greeterImpl{})s.Serve()// Client 调用proxy:=pb.NewGreeterClientProxy()resp,err:=proxy.Hello(ctx,req)

5.2 Codec（编解码）

负责消息打包/拆包、协议头与 body 的处理。tRPC 内置：

• trpc（默认，二进制+protobuf）
• http（HTTP+JSON 或 HTTP+protobuf）
• grpc（HTTP/2+protobuf，与 gRPC 互通）

通过protocol配置切换：

protocol:trpc|http|grpc|http_no_protocol

5.3 Transport（传输层）

抽象底层网络通信，默认 TCP，支持：

• TCP / UDP
• 自定义 transport（如基于共享内存）

5.4 Filter（拦截器）

类似 Java Servlet Filter / Express middleware，对所有调用做横切处理：

typeFilterfunc(ctx context.Context,req,rsp any,next Handler)error

经典用途：

• 日志、监控、链路追踪；
• 鉴权；
• 限流熔断；
• 重试。

注册：

server:filter:[recovery,debuglog,openTelemetry]client:filter:[retry,breaker,debuglog]

5.5 Selector（服务发现 + LB + 路由）

selector("polaris://trpc.app.user") │ ├─ Discovery：拉实例列表 ├─ ServiceRouter：路由筛选 ├─ LoadBalancer：负载均衡 └─ CircuitBreaker：熔断

每一步都可独立替换。

5.6 Naming（命名服务）

target 的格式：

<schema>://<service-name>?<key=value>&<key=value>

例：

polaris://trpc.app.user?namespace=Production ip://127.0.0.1:8000 dns://www.example.com:80

5.7 Plugin

插件框架是 tRPC-Go 的"骨架"。注册一个插件：

plugin.Register("polaris",&PolarisPlugin{})

启动时根据trpc_go.yaml加载对应插件。

六、一次完整的服务端调用流程

1. TCP accept （Transport） 2. 拆包 + 解码协议头 （Codec） 3. 解码 body 为 message （Codec） 4. 路由到 method （Server） 5. Filter 链：日志 / 监控 / 鉴权… （Filter） 6. 调用 handler （业务代码） 7. 返回值经 Filter 反向链 （Filter） 8. 编码响应 （Codec） 9. 写回 TCP （Transport）

七、一次完整的客户端调用流程

1. proxy.Method(ctx, req) 2. Filter 链：retry / circuit / 监控 3. Selector：选目标实例 4. Codec：编码 req 5. Transport：网络发送 6. Transport：接收 response 7. Codec：解码 response 8. Filter 链反向 9. 返回业务调用方

八、生态全景

围绕 tRPC-Go 还有一系列周边：

九、与 gRPC 的关系

tRPC 不是要取代 gRPC，而是包含 gRPC：

• 你可以让 tRPC 服务以 gRPC 协议对外提供；
• 你可以让 tRPC 客户端调用 gRPC 服务；
• 也可以让 tRPC 服务被 gRPC 客户端调用。

所谓"协议互通"是 tRPC 设计中重要的一环。

十、最小化体验

# 1. 安装命令行工具goinstalltrpc.group/trpc-go/trpc-cmdline/trpc@latest# 2. 创建一个 protocat>hello.proto<<'EOF' syntax = "proto3"; package helloworld; option go_package = "git.code.oa.com/examples/helloworld"; service HelloWorld { rpc Hello(HelloReq) returns (HelloRsp); } message HelloReq { string msg = 1; } message HelloRsp { string msg = 1; } EOF# 3. 生成项目骨架trpc create-phello.proto-o.# 4. 启动go run main.go

十一、小结

• tRPC-Go = 多语言 + 多协议 + 全插件化的 RPC 框架；
• 一切皆插件 / 接口先行 / 配置驱动 三大设计原则；
• 核心组件：Codec、Transport、Filter、Selector、Plugin；
• 与 Polaris、北极星、七彩石、天机阁等深度集成。

下一篇我们将动手搭建第一个 tRPC-Go 服务，从 0 到 1 跑通 Hello World。