罗罗编程学习记录
本页内容 展开查看

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 面向内网服务编排与微服务拆分。

原理流程

  1. 识别调用边界:对外契约接口 vs 内部服务协作。
  2. 内部高频、方法明确的调用选 RPC。
  3. 跨团队、对外开放、需浏览器直连的场景用 HTTP。
  4. 混合架构中两种方式按服务边界并存。

代码或图示

// 外部客户端 → HTTP REST API → 业务服务
// 业务服务 ↔ RPC ↔ 订单服务 / 用户服务 / 库存服务(内网)

常见误区

  • 把 RPC 暴露到公网:缺少外部契约治理与鉴权边界,应只监听内网或经网关。
  • 内部调用也全部走 REST:序列化与 HTTP 开销大,方法语义映射繁琐。

追问

  • Hyperf 支持哪些 RPC 协议?答:JSON-RPC(TCP jsonrpc 与 HTTP jsonrpc-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 官方标准为准。

原理流程

  1. 客户端组装请求:版本号、方法名、参数、请求 ID。
  2. 序列化为 JSON 经协议传输。
  3. 服务端按方法名分发执行。
  4. 返回结果或错误对象,携带同一 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 服务节点。

原理流程

  1. 定义服务接口约定方法签名。
  2. 实现类标注 #[RpcService] 并填属性。
  3. 启动期扫描注解,把服务注册到对应 RPC Server。
  4. 按 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。强类型签名在两端同步,减少序列化错配。接口可放在共享包,或按版本在各服务内复制维护。

原理流程

  1. 编写接口方法签名(标量、数组、可空类型)。
  2. 服务端类实现接口并写业务逻辑。
  3. 客户端消费者类实现同一接口,方法内转发 RPC 调用。
  4. 接口演进时两端同步更新并保留兼容。

代码或图示

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 请求发出并解析响应。业务注入消费者类像调本地服务一样使用。

原理流程

  1. 消费者类继承抽象客户端并实现服务接口。
  2. 设置服务名、协议等属性。
  3. 每个接口方法调用 __request(__FUNCTION__, compact(...))。
  4. 容器注入消费者实例,业务直接调用方法。

代码或图示

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 可选,作为容器内依赖注入标识。未接注册中心时还需在配置中指定节点列表。

原理流程

  1. 在 consumers 增加一项服务配置。
  2. name 与服务端 #[RpcService] 一致。
  3. service 指向本地接口类,protocol 与服务端匹配。
  4. 客户端解析时按配置选择注册中心或直连节点。

代码或图示

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 协议兼容现有网关、代理与监控链路。选型结合部署网络与组件成熟度。

原理流程

  1. 按部署形态选择传输:内网直连用 TCP,需 HTTP 基础设施用 HTTP。
  2. 服务端 #[RpcService] 的 protocol 与客户端配置一致。
  3. 报文按 JSON-RPC 结构打包。
  4. 响应解析后返回业务结果。

代码或图示

// 服务端
#[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 一致。

原理流程

  1. 客户端把方法名、参数交给 Packer 编码为报文。
  2. Transporter 发送字节到服务端。
  3. 服务端 Packer 解码报文,分发方法执行。
  4. 结果经 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 超时应短于上游调用超时,形成逐层递减的超时链;不可无限等待下游。

原理流程

  1. 消费者配置声明超时(连接超时、响应超时)。
  2. 客户端发起调用启动计时器。
  3. 超时未响应:中断等待,抛出超时异常。
  4. 业务按策略重试、降级或返回错误。

代码或图示

// 超时配置项键名以组件版本为准(待确认)
return [
    'consumers' => [
        [
            'name' => 'UserService',
            'protocol' => 'jsonrpc',
            'timeout' => 3.0,
        ],
    ],
];

常见误区

  • 不设超时:下游挂死时协程一直等待,连接与协程资源耗尽。
  • 超时大于上游超时:上游已断开,下游结果无人接收。

追问

  • 超时后连接会释放吗?答:客户端按连接池策略归还/重建连接;具体行为以 Transporter 实现为准(待确认)。
  • 慢调用怎么发现?答:记录 RPC 调用耗时分布,慢接口纳入服务端性能治理。

06.5.5.8-010 重试策略如何设计才安全?

一句话结论

重试只对幂等读操作或可安全重复执行的写操作开启,限制重试次数与退避间隔;非幂等写操作重试可能造成重复扣款/重复下单,必须先保证业务幂等。

概念解释

网络抖动、瞬时超时可重试;业务失败(参数错误、状态不允许)不应重试。重试叠加超时形成容错链,次数过多会放大下游压力,需设置上限与熔断配合。

原理流程

  1. 判断操作幂等性:查询/可重复写可重试。
  2. 失败分类:瞬时错误进入重试,业务错误直接返回。
  3. 按退避策略重试有限次数。
  4. 仍失败走降级或上报告警。

代码或图示

// 概念示例:有限次重试 + 退避;具体组件重试配置待确认
$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 等组件),客户端从注册中心拉取可用节点;注册中心故障时可结合本地直连配置兜底。

概念解释

注册中心维护服务名到节点列表的映射与健康状态。服务启动注册、下线摘除;客户端订阅列表变化并刷新本地节点缓存。具体注册中心组件按项目选型安装。

原理流程

  1. 安装对应注册中心组件并配置地址。
  2. 服务端启动把服务名、协议、节点信息上报。
  3. 客户端按服务名拉取节点列表,健康检查剔除异常节点。
  4. 节点上下线时列表动态更新。

代码或图示

#[RpcService(name: "UserService", protocol: "jsonrpc", server: "jsonrpc", publishTo: "consul")]
class UserService implements UserServiceInterface
{
}

常见误区

  • 注册中心地址未配置:服务端上报失败,客户端找不到节点。
  • 依赖注册中心单点无兜底:注册中心故障影响服务发现,需高可用部署或本地节点缓存。

追问

  • 健康检查由谁做?答:注册中心或组件按配置探测;摘除策略对照对应注册组件文档(待确认)。
  • 直连模式怎么配置?答:不接注册中心时在消费者配置写固定节点;适合开发环境与小规模部署。

06.5.5.8-012 负载均衡策略如何选择?

一句话结论

客户端在多个可用节点间按策略选择调用目标,常见 random、轮询;无状态服务用随机/轮询即可,有状态或权重差异场景按节点能力调整策略。

概念解释

负载均衡发生在客户端侧(消费者),基于注册中心节点列表。策略选择需结合节点配置一致性、会话保持需求与下游容量;节点不健康应被剔除后再均衡。

原理流程

  1. 客户端获取服务可用节点列表。
  2. 按配置策略(random/轮询等)选择节点。
  3. 建立连接发起调用。
  4. 调用失败按策略重试其他节点或上报。

代码或图示

'consumers' => [
    [
        'name' => 'OrderService',
        'load_balancer' => 'random', // 可选策略以组件为准
    ],
],

常见误区

  • 节点规格不同却用无差别轮询:小节点被打满,应支持权重策略。
  • 不剔除故障节点:请求持续落到已下线实例。

追问

  • 一致性哈希有必要吗?答:需要会话/缓存亲和性时考虑;无状态内部服务通常不需要。
  • 策略可自定义吗?答:按组件扩展点实现均衡器接口;具体扩展方式待确认。

06.5.5.8-013 异常如何跨服务传递与映射?

一句话结论

服务端异常被包装为 JSON-RPC error 对象(code/message)返回,客户端解码后抛出对应异常;业务错误码与系统异常应区分,调用方按 code 分支处理。

概念解释

跨进程不能直接传递 PHP 异常对象,只能传输结构化错误信息。约定错误码段:业务错误、参数错误、系统错误分别编码;服务端避免把内部堆栈细节暴露给调用方。

原理流程

  1. 服务端方法抛出异常。
  2. RPC 服务端处理器捕获,构造 error 响应。
  3. 客户端收到错误对象,转为本地异常抛出。
  4. 调用方按错误码判断重试、降级或返回业务错误。

代码或图示

$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 集成)负责注入与提取,业务不手动拼接。

原理流程

  1. 客户端从上下文取 trace_id 与当前 span 信息。
  2. 调用前注入 RPC 报文元数据。
  3. 服务端入口提取标识,写入自己的上下文。
  4. 服务端继续调用下游时透传,监控系统按 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 端口暴露公网。

概念解释

服务间信任不能只靠“在内网”。鉴权方式包括静态令牌、签名时间戳防重放、注册中心实例身份。敏感操作在服务端再次校验权限,不信任调用方传入的用户态越权数据。

原理流程

  1. 客户端从配置获取服务凭证,组装鉴权元数据。
  2. 报文携带身份与签名信息。
  3. 服务端校验凭证有效期、签名与时间戳。
  4. 校验失败拒绝调用并记录安全日志。

代码或图示

// 概念示例:请求元数据携带服务凭证(密钥从配置读取,不硬编码)
$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。

原理流程

  1. 消费者解析客户端,初始化对应 Transporter 连接池。
  2. 调用时取连接,打包报文发送。
  3. 等待响应期间连接被当前协程独占。
  4. 响应到达归还连接,供后续调用复用。

代码或图示

// 业务侧只注入消费者,不直接管理连接
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 链延长响应时间,并行可把多个下游耗时压缩到最慢一个。并发调用需注意:超时各自独立、结果按标识收集、上下文复制、下游承载能力上限。

原理流程

  1. 梳理可并行的下游调用与结果依赖。
  2. 派生协程分别调用 RPC 客户端。
  3. 等待工具收集各协程结果与异常。
  4. 主协程汇总结果,处理部分失败场景。

代码或图示

// 概念示例:并发调用用户与订单服务;并发工具类名以项目封装为准(待确认)
[$user, $orders] = parallel(
    fn () => $this->userClient->getInfo($userId),
    fn () => $this->orderClient->listByUser($userId),
);

常见误区

  • 无限制并发派生协程:下游与本地协程数被打爆,需并发上限。
  • 子协程直接读父上下文:未复制时 trace_id/用户态丢失(见上下文专题)。

追问

  • 部分下游失败怎么处理?答:按业务选择快速失败或降级兜底;结果收集需区分成功/失败分支。
  • 并行调用顺序敏感吗?答:无共享写操作时并行安全;有先后依赖的必须串行。

06.5.5.8-018 服务端并发限制与过载保护怎么做?

一句话结论

服务端通过 Worker/协程规模、连接与队列容量控制并发,下游依赖有限流与熔断;过载时快速拒绝而非堆积,保护自身不被拖垮,并向上游传递可处理的错误。

概念解释

RPC 服务可能被突发流量打满:单请求变慢会堆积协程与连接。保护手段包括并发上限、超时兜底、限流组件、熔断断开故障下游,以及资源隔离(不同服务分进程/连接池)。

原理流程

  1. 评估单服务并发承载与下游依赖容量。
  2. 配置 Worker 数、连接池上限与限流阈值。
  3. 下游故障时熔断,避免等待耗尽资源。
  4. 过载请求快速失败,配合上游重试与降级。

代码或图示

// 入口限流 → 并发协程上限 → 下游调用超时/熔断 → 资源隔离
// ↓ 超出阈值
// 快速拒绝(业务错误码)+ 告警

常见误区

  • 服务端不设并发上限:慢请求堆积导致内存与协程数持续上涨。
  • 熔断只在客户端做:服务端自身没有保护,被故障下游连带拖垮。

追问

  • Hyperf 有限流/熔断组件吗?答:生态提供限流器、熔断器类组件(具体包名待确认);接入后按资源维度配置阈值。
  • 过载时返回什么响应?答:明确的繁忙/限流错误码,便于上游退避重试,不返回模糊 500。

06.5.5.8-019 接口版本演进如何保持兼容?

一句话结论

演进遵循向后兼容:新增可选参数与返回字段优先,不改老字段语义;不兼容变更通过新服务名/新方法版本号发布,旧版本保留过渡期,两端按版本对接。

概念解释

跨服务接口一旦被多方依赖,改签名影响面大。兼容策略:新增字段给默认值、废弃字段标注过渡期、破坏性变更升版本。接口变更需同步消费者并验证。

原理流程

  1. 评估变更是否破坏老调用方。
  2. 兼容变更:加可选参数/字段,老调用不受影响。
  3. 不兼容变更:新版本服务名/方法,老版本并行维护。
  4. 消费者逐步迁移后下线旧版本。

代码或图示

// 兼容演进:新增可选参数带默认值
public function getInfo(int $id, bool $withProfile = false): array
{
    // 老调用不传第二参数,行为不变
}

// 破坏性变更:新版本服务
class UserServiceV2 implements UserServiceV2Interface
{
}

常见误区

  • 直接改已有参数类型/含义:老消费者反序列化或校验失败。
  • 不通知消费者就下线旧方法:依赖方调用报方法不存在。

追问

  • 接口文档怎么维护?答:契约与代码同步更新,消费者按文档对接;复杂 DTO 字段结构单独管理。
  • 废弃字段如何标记?答:在接口注释与错误提示中标注废弃与替代版本,给迁移周期。

06.5.5.8-020 RPC 调用不通的排查清单是什么?

一句话结论

按“注册/配置 → 协议端口 → 网络连通 → 报文序列化 → 服务端分发 → 异常响应”逐层排查:先确认服务名、协议、节点与端口一致,再验证报文与方法签名,最后看服务端日志。

概念解释

调用不通常见原因:服务名/协议不匹配、注册中心无节点、端口未放行、序列化字段错位、方法不存在、服务端异常。逐层排除比反复重启高效。

原理流程

  1. 核对消费者配置:name、service、protocol、节点/注册中心。
  2. 检查服务端 #[RpcService] 属性与 Server 监听端口。
  3. 验证网络连通(端口可达、防火墙/安全组)。
  4. 抓包或日志检查报文结构与方法名。
  5. 查看服务端异常日志与返回的错误码。

代码或图示

// # 示例:检查端口监听与连通性(按实际环境执行)
// # netstat -ano | findstr 9502
// # telnet <服务地址> 9502

常见误区

  • 不看错误码只重启:配置或签名问题重启不会修复。
  • 忽略两端协议差异:TCP/HTTP 混用是高频失败点。

追问

  • 调用超时但服务端正常?答:检查网络、超时配置、连接池耗尽与下游慢调用。
  • 报方法不存在?答:核对方法名大小写、参数结构与接口版本,确认服务端实现类已扫描注册。