06.5.5.8 RPC 与 JSON-RPC
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf
06.5.5.8-001 Hyperf RPC 解决什么问题?与 HTTP API 如何取舍?
一句话结论
RPC 用于内部服务间按方法语义互相调用,调用方像调本地方法一样发起远程请求;对外开放接口用 HTTP REST,内部高性能、强关联服务调用适合 RPC,两者按边界选型。
概念解释
RPC 屏蔽传输与序列化细节:客户端代理把方法名与参数打包发出,服务端分发到实现类返回结果。HTTP API 面向外部契约与浏览器/移动端;RPC 面向内网服务编排与微服务拆分。
原理流程
- 识别调用边界:对外契约接口 vs 内部服务协作。
- 内部高频、方法明确的调用选 RPC。
- 跨团队、对外开放、需浏览器直连的场景用 HTTP。
- 混合架构中两种方式按服务边界并存。
代码或图示
// 外部客户端 → HTTP REST API → 业务服务
// 业务服务 ↔ RPC ↔ 订单服务 / 用户服务 / 库存服务(内网)
常见误区
- 把 RPC 暴露到公网:缺少外部契约治理与鉴权边界,应只监听内网或经网关。
- 内部调用也全部走 REST:序列化与 HTTP 开销大,方法语义映射繁琐。
追问
- Hyperf 支持哪些 RPC 协议?答:JSON-RPC(TCP
jsonrpc与 HTTPjsonrpc-http),生态另有 gRPC 组件;具体可用协议以安装包为准(待确认)。 - RPC 能替代消息队列吗?答:不能,RPC 是同步请求响应,异步解耦与削峰仍需消息队列。
06.5.5.8-002 JSON-RPC 2.0 报文结构是什么?
一句话结论
请求报文含 jsonrpc 版本、method 方法名、params 参数与 id;成功响应含 result,失败响应含 error(code/message/data),id 用于请求响应匹配。
概念解释
JSON-RPC 2.0 是无状态、轻量的 JSON 序列化协议。params 可为位置数组或命名对象;通知(notification)不带 id,服务端不返回响应。规范字段以 JSON-RPC 2.0 官方标准为准。
原理流程
- 客户端组装请求:版本号、方法名、参数、请求 ID。
- 序列化为 JSON 经协议传输。
- 服务端按方法名分发执行。
- 返回结果或错误对象,携带同一
id匹配。
代码或图示
// 请求报文
$request = ['jsonrpc' => '2.0', 'method' => 'add', 'params' => [1, 2], 'id' => 1];
// 成功响应
$success = ['jsonrpc' => '2.0', 'result' => 3, 'id' => 1];
// 错误响应
$error = ['jsonrpc' => '2.0', 'error' => ['code' => -32000, 'message' => 'user not found'], 'id' => 1];
常见误区
- 响应缺少
id:并发调用时无法匹配请求与响应。 - 错误对象只给消息不给 code:调用方无法按错误类型分支处理。
追问
- 批量调用支持吗?答:JSON-RPC 规范支持批量数组请求,服务端返回响应数组;框架客户端是否封装批量调用待确认。
params用数组还是对象?答:位置参数用数组,命名参数用对象;服务端接口约定需与客户端一致。
06.5.5.8-003 服务端 #[RpcService] 注解如何配置?
一句话结论
在服务实现类上标注 #[RpcService],通过 name 指定服务名、protocol 指定协议、server 指定挂载的 Server、publishTo 指定注册中心;类方法即对外暴露的 RPC 方法。
概念解释
注解命名空间为 Hyperf\RpcServer\Annotation\RpcService。服务名是客户端查找的逻辑标识,需与消费者配置一致;server 对应 server.php 中的 RPC 服务节点。
原理流程
- 定义服务接口约定方法签名。
- 实现类标注
#[RpcService]并填属性。 - 启动期扫描注解,把服务注册到对应 RPC Server。
- 按
publishTo配置上报注册中心。
代码或图示
use Hyperf\RpcServer\Annotation\RpcService;
#[RpcService(name: "UserService", protocol: "jsonrpc", server: "jsonrpc", publishTo: "consul")]
class UserService implements UserServiceInterface
{
public function getInfo(int $id): array
{
return ['id' => $id, 'name' => 'ann'];
}
}
常见误区
name与消费者配置不一致:客户端找不到服务,调用失败。- 服务实现未实现接口约定:方法签名与客户端代理不一致,参数映射出错。
追问
publishTo可选吗?答:不接注册中心时可直连配置节点;属性取值与可选行为以版本为准(待确认)。- 一个类能暴露多个服务名吗?答:按注解定义单服务名;多服务应拆为不同实现类。
06.5.5.8-004 服务端接口约定如何组织?
一句话结论
先定义接口(Interface)声明方法与参数/返回类型,服务端实现接口,客户端按同一接口生成代理;接口是跨服务契约,两端共享或同步维护签名。
概念解释
接口方法名与参数顺序对应 RPC method 与 params。强类型签名在两端同步,减少序列化错配。接口可放在共享包,或按版本在各服务内复制维护。
原理流程
- 编写接口方法签名(标量、数组、可空类型)。
- 服务端类实现接口并写业务逻辑。
- 客户端消费者类实现同一接口,方法内转发 RPC 调用。
- 接口演进时两端同步更新并保留兼容。
代码或图示
interface UserServiceInterface
{
public function getInfo(int $id): array;
public function create(string $name, int $gender): array;
}
class UserService implements UserServiceInterface
{
public function getInfo(int $id): array
{
return ['id' => $id];
}
}
常见误区
- 两端方法名拼写不一致:服务端分发不到方法,返回方法不存在错误。
- 参数类型不匹配:JSON 弱类型传输,服务端收到字符串/数组结构与声明不符。
追问
- 复杂参数怎么传输?答:用关联数组或 DTO 数组结构序列化;对象跨服务需约定字段结构,不能直接传 PHP 类实例引用。
- 接口版本怎么管理?答:服务名或方法名带版本段(如
UserServiceV2),旧版本保留兼容过渡期。
06.5.5.8-005 客户端代理如何定义与调用?
一句话结论
客户端类继承 AbstractServiceClient,声明 $serviceName 与 $protocol,接口方法内调用 __request() 转发方法名与参数;容器解析后代理屏蔽网络与序列化细节。
概念解释
基类命名空间为 Hyperf\RpcClient\AbstractServiceClient。__request 接收方法名与参数数组,打包成 JSON-RPC 请求发出并解析响应。业务注入消费者类像调本地服务一样使用。
原理流程
- 消费者类继承抽象客户端并实现服务接口。
- 设置服务名、协议等属性。
- 每个接口方法调用
__request(__FUNCTION__, compact(...))。 - 容器注入消费者实例,业务直接调用方法。
代码或图示
use Hyperf\RpcClient\AbstractServiceClient;
class UserServiceClient extends AbstractServiceClient implements UserServiceInterface
{
protected string $serviceName = 'UserService';
protected string $protocol = 'jsonrpc-http';
public function getInfo(int $id): array
{
return $this->__request('getInfo', compact('id'));
}
}
常见误区
$serviceName与服务端name不一致:注册/解析匹配失败。- 参数用位置传参与服务端约定不符:
compact生成命名数组,序列化结构需两端对齐。
追问
__request返回类型如何保证?答:服务端返回数组/标量,强类型由业务层校验;代理不自动做类型转换(待确认当前版本行为)。- 客户端需要单独安装包吗?答:RPC 客户端组件随
hyperf/rpc-client类包引入;核对 composer 依赖。
06.5.5.8-006 services.php 消费者配置如何写?
一句话结论
config/autoload/services.php 的 consumers 数组按服务名登记消费者:name 对应服务端服务名,service 绑定接口类,protocol 协议,load_balancer 负载策略;容器按配置解析客户端。
概念解释
配置把逻辑服务名映射到接口与协议,支持多实例负载均衡。id 可选,作为容器内依赖注入标识。未接注册中心时还需在配置中指定节点列表。
原理流程
- 在
consumers增加一项服务配置。 name与服务端#[RpcService]一致。service指向本地接口类,protocol与服务端匹配。- 客户端解析时按配置选择注册中心或直连节点。
代码或图示
return [
'consumers' => [
[
'name' => 'UserService',
'service' => \App\JsonRpc\UserServiceInterface::class,
'protocol' => 'jsonrpc',
'load_balancer' => 'random',
],
],
];
常见误区
- 协议两端不一致:TCP 客户端连 HTTP 端口或反之,握手/报文解析失败。
- 漏配
service接口类:容器无法把消费者绑定到接口注入。
追问
- 直连节点怎么配?答:消费者配置可登记固定节点列表;具体节点配置键名以组件版本为准(待确认)。
- 负载均衡策略有哪些?答:常见 random、轮询等;可用策略列表对照 RPC 组件文档(待确认)。
06.5.5.8-007 jsonrpc 与 jsonrpc-http 协议有什么区别?
一句话结论
jsonrpc 走 TCP 长连接自定义报文封装,适合内网高频调用;jsonrpc-http 复用 HTTP 传输,便于穿透 HTTP 基础设施与混合部署,序列化同为 JSON-RPC 报文。
概念解释
两者报文层都是 JSON-RPC 2.0,差别在传输层:TCP 协议开销低、可长连接复用;HTTP 协议兼容现有网关、代理与监控链路。选型结合部署网络与组件成熟度。
原理流程
- 按部署形态选择传输:内网直连用 TCP,需 HTTP 基础设施用 HTTP。
- 服务端
#[RpcService]的protocol与客户端配置一致。 - 报文按 JSON-RPC 结构打包。
- 响应解析后返回业务结果。
代码或图示
// 服务端
#[RpcService(name: "OrderService", protocol: "jsonrpc", server: "jsonrpc")]
// 客户端配置
'protocol' => 'jsonrpc',
常见误区
- 一端 TCP 一端 HTTP:端口监听与报文格式不匹配,连接即失败。
- 用 HTTP RPC 追求极致低延迟:HTTP 头与连接管理有额外开销,TCP 更轻量。
追问
- 报文封装格式由谁定?答:RPC 组件的 Packer 实现;TCP 协议的帧分隔方式(如 EOF 分隔)以组件为准(待确认)。
- 同一服务能同时提供两种协议吗?答:按多 Server 配置分别挂载,具体支持程度对照组件文档。
06.5.5.8-008 RPC 序列化与 Packer 如何工作?
一句话结论
Packer 负责在 JSON-RPC 报文与 PHP 数据结构之间编码解码:请求参数数组序列化为 params,响应 result/error 解码为返回值或异常;序列化格式以 JSON 为主。
概念解释
传输层(Transporter)负责收发字节,Packer 负责结构编解码,PathGenerator 负责方法名映射。三层协作完成一次调用;更换序列化格式需两端 Packer 一致。
原理流程
- 客户端把方法名、参数交给 Packer 编码为报文。
- Transporter 发送字节到服务端。
- 服务端 Packer 解码报文,分发方法执行。
- 结果经 Packer 编码返回,客户端解码为返回值。
代码或图示
// 调用方 → Packer 编码 → Transporter 发送 → 网络 → Transporter 接收 → Packer 解码 → 服务方法
$payload = json_encode(['method' => $method, 'params' => $params]);
$result = json_decode($raw, true);
常见误区
- 跨服务传 PHP 对象实例:JSON 序列化后无类信息,反序列化不会还原为原类。
- 两端 Packer/编码不一致:解码失败或字段错位。
追问
- 支持 MessagePack 等二进制编码吗?答:生态 Packer 扩展能力以安装包为准(待确认);默认 JSON 兼容性最好。
- 大报文序列化有什么注意?答:控制单次参数与返回体积,避免超大数组跨服务传输。
06.5.5.8-009 RPC 超时如何配置与控制?
一句话结论
客户端调用必须设置超时时间,覆盖连接建立与响应等待;超时后中止等待并按业务重试或降级,避免协程长期挂起拖垮服务。
概念解释
超时配置在消费者配置或客户端调用层,具体配置键名与默认值以 RPC 组件版本为准。RPC 超时应短于上游调用超时,形成逐层递减的超时链;不可无限等待下游。
原理流程
- 消费者配置声明超时(连接超时、响应超时)。
- 客户端发起调用启动计时器。
- 超时未响应:中断等待,抛出超时异常。
- 业务按策略重试、降级或返回错误。
代码或图示
// 超时配置项键名以组件版本为准(待确认)
return [
'consumers' => [
[
'name' => 'UserService',
'protocol' => 'jsonrpc',
'timeout' => 3.0,
],
],
];
常见误区
- 不设超时:下游挂死时协程一直等待,连接与协程资源耗尽。
- 超时大于上游超时:上游已断开,下游结果无人接收。
追问
- 超时后连接会释放吗?答:客户端按连接池策略归还/重建连接;具体行为以 Transporter 实现为准(待确认)。
- 慢调用怎么发现?答:记录 RPC 调用耗时分布,慢接口纳入服务端性能治理。
06.5.5.8-010 重试策略如何设计才安全?
一句话结论
重试只对幂等读操作或可安全重复执行的写操作开启,限制重试次数与退避间隔;非幂等写操作重试可能造成重复扣款/重复下单,必须先保证业务幂等。
概念解释
网络抖动、瞬时超时可重试;业务失败(参数错误、状态不允许)不应重试。重试叠加超时形成容错链,次数过多会放大下游压力,需设置上限与熔断配合。
原理流程
- 判断操作幂等性:查询/可重复写可重试。
- 失败分类:瞬时错误进入重试,业务错误直接返回。
- 按退避策略重试有限次数。
- 仍失败走降级或上报告警。
代码或图示
// 概念示例:有限次重试 + 退避;具体组件重试配置待确认
$attempts = 3;
for ($i = 1; $i <= $attempts; $i++) {
try {
return $this->userClient->getInfo($id);
} catch (\Throwable $e) {
if ($i === $attempts) {
throw $e;
}
usleep(100 * $i * 1000);
}
}
常见误区
- 写接口盲目自动重试:重复创建订单/重复扣款。
- 无退避立即重试:下游故障时重试风暴加剧压力。
追问
- 重试与幂等键怎么配合?答:写操作携带业务幂等键,服务端按键去重,重试安全才有保障。
- 框架内置重试组件吗?答:RPC/重试组件能力以生态包为准(待确认);自研需覆盖超时、连接失败等错误分类。
06.5.5.8-011 服务注册与发现如何接入?
一句话结论
服务端通过 publishTo 上报注册中心(Consul/Nacos/ETCD 等组件),客户端从注册中心拉取可用节点;注册中心故障时可结合本地直连配置兜底。
概念解释
注册中心维护服务名到节点列表的映射与健康状态。服务启动注册、下线摘除;客户端订阅列表变化并刷新本地节点缓存。具体注册中心组件按项目选型安装。
原理流程
- 安装对应注册中心组件并配置地址。
- 服务端启动把服务名、协议、节点信息上报。
- 客户端按服务名拉取节点列表,健康检查剔除异常节点。
- 节点上下线时列表动态更新。
代码或图示
#[RpcService(name: "UserService", protocol: "jsonrpc", server: "jsonrpc", publishTo: "consul")]
class UserService implements UserServiceInterface
{
}
常见误区
- 注册中心地址未配置:服务端上报失败,客户端找不到节点。
- 依赖注册中心单点无兜底:注册中心故障影响服务发现,需高可用部署或本地节点缓存。
追问
- 健康检查由谁做?答:注册中心或组件按配置探测;摘除策略对照对应注册组件文档(待确认)。
- 直连模式怎么配置?答:不接注册中心时在消费者配置写固定节点;适合开发环境与小规模部署。
06.5.5.8-012 负载均衡策略如何选择?
一句话结论
客户端在多个可用节点间按策略选择调用目标,常见 random、轮询;无状态服务用随机/轮询即可,有状态或权重差异场景按节点能力调整策略。
概念解释
负载均衡发生在客户端侧(消费者),基于注册中心节点列表。策略选择需结合节点配置一致性、会话保持需求与下游容量;节点不健康应被剔除后再均衡。
原理流程
- 客户端获取服务可用节点列表。
- 按配置策略(random/轮询等)选择节点。
- 建立连接发起调用。
- 调用失败按策略重试其他节点或上报。
代码或图示
'consumers' => [
[
'name' => 'OrderService',
'load_balancer' => 'random', // 可选策略以组件为准
],
],
常见误区
- 节点规格不同却用无差别轮询:小节点被打满,应支持权重策略。
- 不剔除故障节点:请求持续落到已下线实例。
追问
- 一致性哈希有必要吗?答:需要会话/缓存亲和性时考虑;无状态内部服务通常不需要。
- 策略可自定义吗?答:按组件扩展点实现均衡器接口;具体扩展方式待确认。
06.5.5.8-013 异常如何跨服务传递与映射?
一句话结论
服务端异常被包装为 JSON-RPC error 对象(code/message)返回,客户端解码后抛出对应异常;业务错误码与系统异常应区分,调用方按 code 分支处理。
概念解释
跨进程不能直接传递 PHP 异常对象,只能传输结构化错误信息。约定错误码段:业务错误、参数错误、系统错误分别编码;服务端避免把内部堆栈细节暴露给调用方。
原理流程
- 服务端方法抛出异常。
- RPC 服务端处理器捕获,构造
error响应。 - 客户端收到错误对象,转为本地异常抛出。
- 调用方按错误码判断重试、降级或返回业务错误。
代码或图示
$errorResponse = [
'jsonrpc' => '2.0',
'error' => ['code' => 1001, 'message' => '库存不足', 'data' => ['sku_1']],
'id' => 2,
];
常见误区
- 服务端把 SQL 错误、堆栈直接返回:泄露内部信息,应包装为通用系统错误码。
- 客户端只判断异常消息文本:应按错误码分支,消息文案可变。
追问
- 业务异常类如何跨服务复用?答:两端约定错误码与消息结构,本地定义对应异常类;不传输类实例。
- 未捕获异常会怎样?答:服务端处理器兜底转为系统错误响应;未配置处理器时连接行为以组件为准(待确认)。
06.5.5.8-014 链路追踪信息如何跨 RPC 传递?
一句话结论
trace_id、span 信息在调用前注入 RPC 报文元数据或扩展字段,服务端入口提取并写入上下文,继续向下游传递;跨服务日志与监控按同一 trace_id 串联。
概念解释
HTTP 用请求头传递,JSON-RPC 可在报文扩展字段或协议元数据中携带追踪信息。链路组件(如 OpenTracing/OpenTelemetry 集成)负责注入与提取,业务不手动拼接。
原理流程
- 客户端从上下文取 trace_id 与当前 span 信息。
- 调用前注入 RPC 报文元数据。
- 服务端入口提取标识,写入自己的上下文。
- 服务端继续调用下游时透传,监控系统按 trace_id 汇总链路。
代码或图示
// 概念示例:追踪标识随 RPC 元数据传递
$meta = ['trace_id' => Context::get(ContextKeys::TRACE_ID)];
$result = $this->orderClient->__request('detail', ['id' => $id], $meta);
常见误区
- 只在进程内传 trace_id:跨服务边界断裂,链路图缺段。
- 追踪字段名两端不一致:提取不到,链路无法关联。
追问
- 框架有现成追踪集成吗?答:Hyperf 生态提供 Zipkin/Jaeger 类客户端组件;具体包名与接入方式待确认。
- 异步消息怎么续链路?答:消息体携带 trace_id,消费端重建上下文继续。
06.5.5.8-015 服务间调用如何做鉴权与信任?
一句话结论
内网 RPC 仍需服务身份校验:通过共享密钥、签名或服务凭证在报文元数据中携带,服务端校验来源;网络层配合内网隔离与防火墙,不把 RPC 端口暴露公网。
概念解释
服务间信任不能只靠“在内网”。鉴权方式包括静态令牌、签名时间戳防重放、注册中心实例身份。敏感操作在服务端再次校验权限,不信任调用方传入的用户态越权数据。
原理流程
- 客户端从配置获取服务凭证,组装鉴权元数据。
- 报文携带身份与签名信息。
- 服务端校验凭证有效期、签名与时间戳。
- 校验失败拒绝调用并记录安全日志。
代码或图示
// 概念示例:请求元数据携带服务凭证(密钥从配置读取,不硬编码)
$meta = [
'app_id' => (string) config('rpc.app_id'),
'timestamp' => (string) time(),
];
常见误区
- RPC 端口监听 0.0.0.0 且无鉴权:任意可达主机可调用内部服务。
- 信任调用方传入的用户角色:服务端必须按令牌/上下文重新鉴权。
追问
- 凭证轮换怎么做?答:配置支持多版本凭证并行,灰度切换后旧凭证下线。
- 有 mTLS 支持吗?答:按传输层与组件能力确认;TCP/HTTP RPC 的证书配置对照部署文档(待确认)。
06.5.5.8-016 RPC 连接如何复用与协程隔离?
一句话结论
RPC 客户端连接由组件连接池管理,协程借用连接执行调用,用完归还;同一连接不被并发协程共享,长连接复用降低握手开销,连接状态按借用周期隔离。
概念解释
与 DB/Redis 池化模型一致:客户端持有池,每次调用取连接、发报文、等响应、归还。TCP 长连接可在多次调用间复用;HTTP 连接按客户端实现管理 keep-alive。
原理流程
- 消费者解析客户端,初始化对应 Transporter 连接池。
- 调用时取连接,打包报文发送。
- 等待响应期间连接被当前协程独占。
- 响应到达归还连接,供后续调用复用。
代码或图示
// 业务侧只注入消费者,不直接管理连接
class OrderController
{
public function __construct(private OrderServiceClient $orderClient)
{
}
public function show(int $id): array
{
return $this->orderClient->detail($id);
}
}
常见误区
- 在业务层缓存底层连接句柄:绕过池化独占约定。
- 一次调用内并发复用同一连接:报文与响应交叉错乱。
追问
- 连接池参数在哪里配?答:RPC 客户端/Transporter 配置段;键名与默认值以组件为准(待确认)。
- 连接断线如何恢复?答:池内失效连接检测重建;组件自动重连行为对照 Transporter 实现。
06.5.5.8-017 并发 RPC 调用如何组织?
一句话结论
需要并行调用多个下游时,用协程并发工具派生子协程分别发起 RPC,主协程等待全部结果汇总;并发数量受控,共享只读标识显式传入子协程上下文。
概念解释
串行 RPC 链延长响应时间,并行可把多个下游耗时压缩到最慢一个。并发调用需注意:超时各自独立、结果按标识收集、上下文复制、下游承载能力上限。
原理流程
- 梳理可并行的下游调用与结果依赖。
- 派生协程分别调用 RPC 客户端。
- 等待工具收集各协程结果与异常。
- 主协程汇总结果,处理部分失败场景。
代码或图示
// 概念示例:并发调用用户与订单服务;并发工具类名以项目封装为准(待确认)
[$user, $orders] = parallel(
fn () => $this->userClient->getInfo($userId),
fn () => $this->orderClient->listByUser($userId),
);
常见误区
- 无限制并发派生协程:下游与本地协程数被打爆,需并发上限。
- 子协程直接读父上下文:未复制时 trace_id/用户态丢失(见上下文专题)。
追问
- 部分下游失败怎么处理?答:按业务选择快速失败或降级兜底;结果收集需区分成功/失败分支。
- 并行调用顺序敏感吗?答:无共享写操作时并行安全;有先后依赖的必须串行。
06.5.5.8-018 服务端并发限制与过载保护怎么做?
一句话结论
服务端通过 Worker/协程规模、连接与队列容量控制并发,下游依赖有限流与熔断;过载时快速拒绝而非堆积,保护自身不被拖垮,并向上游传递可处理的错误。
概念解释
RPC 服务可能被突发流量打满:单请求变慢会堆积协程与连接。保护手段包括并发上限、超时兜底、限流组件、熔断断开故障下游,以及资源隔离(不同服务分进程/连接池)。
原理流程
- 评估单服务并发承载与下游依赖容量。
- 配置 Worker 数、连接池上限与限流阈值。
- 下游故障时熔断,避免等待耗尽资源。
- 过载请求快速失败,配合上游重试与降级。
代码或图示
// 入口限流 → 并发协程上限 → 下游调用超时/熔断 → 资源隔离
// ↓ 超出阈值
// 快速拒绝(业务错误码)+ 告警
常见误区
- 服务端不设并发上限:慢请求堆积导致内存与协程数持续上涨。
- 熔断只在客户端做:服务端自身没有保护,被故障下游连带拖垮。
追问
- Hyperf 有限流/熔断组件吗?答:生态提供限流器、熔断器类组件(具体包名待确认);接入后按资源维度配置阈值。
- 过载时返回什么响应?答:明确的繁忙/限流错误码,便于上游退避重试,不返回模糊 500。
06.5.5.8-019 接口版本演进如何保持兼容?
一句话结论
演进遵循向后兼容:新增可选参数与返回字段优先,不改老字段语义;不兼容变更通过新服务名/新方法版本号发布,旧版本保留过渡期,两端按版本对接。
概念解释
跨服务接口一旦被多方依赖,改签名影响面大。兼容策略:新增字段给默认值、废弃字段标注过渡期、破坏性变更升版本。接口变更需同步消费者并验证。
原理流程
- 评估变更是否破坏老调用方。
- 兼容变更:加可选参数/字段,老调用不受影响。
- 不兼容变更:新版本服务名/方法,老版本并行维护。
- 消费者逐步迁移后下线旧版本。
代码或图示
// 兼容演进:新增可选参数带默认值
public function getInfo(int $id, bool $withProfile = false): array
{
// 老调用不传第二参数,行为不变
}
// 破坏性变更:新版本服务
class UserServiceV2 implements UserServiceV2Interface
{
}
常见误区
- 直接改已有参数类型/含义:老消费者反序列化或校验失败。
- 不通知消费者就下线旧方法:依赖方调用报方法不存在。
追问
- 接口文档怎么维护?答:契约与代码同步更新,消费者按文档对接;复杂 DTO 字段结构单独管理。
- 废弃字段如何标记?答:在接口注释与错误提示中标注废弃与替代版本,给迁移周期。
06.5.5.8-020 RPC 调用不通的排查清单是什么?
一句话结论
按“注册/配置 → 协议端口 → 网络连通 → 报文序列化 → 服务端分发 → 异常响应”逐层排查:先确认服务名、协议、节点与端口一致,再验证报文与方法签名,最后看服务端日志。
概念解释
调用不通常见原因:服务名/协议不匹配、注册中心无节点、端口未放行、序列化字段错位、方法不存在、服务端异常。逐层排除比反复重启高效。
原理流程
- 核对消费者配置:
name、service、protocol、节点/注册中心。 - 检查服务端
#[RpcService]属性与 Server 监听端口。 - 验证网络连通(端口可达、防火墙/安全组)。
- 抓包或日志检查报文结构与方法名。
- 查看服务端异常日志与返回的错误码。
代码或图示
// # 示例:检查端口监听与连通性(按实际环境执行)
// # netstat -ano | findstr 9502
// # telnet <服务地址> 9502
常见误区
- 不看错误码只重启:配置或签名问题重启不会修复。
- 忽略两端协议差异:TCP/HTTP 混用是高频失败点。
追问
- 调用超时但服务端正常?答:检查网络、超时配置、连接池耗尽与下游慢调用。
- 报方法不存在?答:核对方法名大小写、参数结构与接口版本,确认服务端实现类已扫描注册。