应封装RpcClient统一处理通信与错误，各业务服务类（如UserRpcService）仅调用其call方法；配置显式超时、HTTPS校验及响应解析路径；通过接口抽象+构造注入支持测试隔离；所有业务状态判断必须收口至RpcClient层。
ThinkPHP里怎么让RPC调用像本地函数一样用
直接封装成服务类 + 代理方法，别碰框架核心的think\Service或think\Container自动绑定逻辑。ThinkPHP本身不内置RPC客户端，强行塞进服务容器容易和配置加载顺序、实例生命周期冲突。
常见错误是把Http::post()或guzzlehttp/guzzle请求逻辑直接写在控制器里，结果每个接口都要重复处理序列化、超时、重试、错误码映射——这不是RPC，是裸HTTP调用。
- 统一用一个
RpcClient类封装底层通信（推荐用guzzlehttp/guzzle，兼容PSR-18更稳） - 每个业务服务单独建类，如
UserRpcService，内部只调用RpcClient::call()，不拼URL、不手动json_encode - 方法名严格对应远端提供的接口名，参数直接透传数组，避免在服务层做字段映射（那是DTO层的事）
如何避免RPC超时导致整个页面卡死
默认Guzzle没设超时，遇到远端hang住，PHP进程会等满max_execution_time，用户看到白屏或504。必须显式控制连接+读取超时，且不能全靠try/catch吞掉异常。
ThinkPHP的config/rpc.php里建议这样配：
立即学习“PHP免费学习笔记（深入）”；
'timeout' => [
'connect' => 1.5,
'read' => 3.0
]
注意：数值单位是秒，小数点后一位足够；connect不能大于read，否则Guzzle会报错。
- 生产环境禁用
verify => false，HTTPS证书校验失败比超时更难排查 - 不要在
__construct里初始化Guzzle Client，按需创建或用静态实例+连接池（简单项目用static $client即可） - 超时异常必须区分
GuzzleHttp\Exception\ConnectException和RequestException，前者可降级，后者要告警
怎么让RpcService支持自动注入又不破坏单元测试
ThinkPHP的make()能自动解析依赖，但RpcService如果硬依赖RpcClient实例，测试时就绕不开网络。解法是用接口抽象+构造器注入，而不是在方法里app()->make(RpcClient::class)。
定义RpcClientInterface，让RpcClient实现它；UserRpcService构造函数声明类型提示：public function __construct(RpcClientInterface $client)。
- 容器绑定写在
app/provider.php里：$app->bind(RpcClientInterface::class, RpcClient::class) - 单元测试时直接传入Mock对象：
new UserRpcService($mockClient)，完全隔离网络 - 别用
app('rpc_client')这种字符串键访问，IDE无法跳转，重构时容易漏改
为什么RPC返回的错误码总对不上业务需求
远端返回{"code":5001,"msg":"token expired"}，你却在控制器里写if ($res['code'] === 1)判断成功——这是最常踩的坑。RPC调用本身成功（HTTP 200），不代表业务成功。
必须在RpcClient::call()里统一拦截并转换：HTTP非2xx抛异常；2xx但code !== 0也抛自定义异常（如RpcBusinessException），由上层try捕获处理。
- 禁止在RpcService方法里用
isset($res['code'])做分支，所有状态判断收口到RpcClient - 远端返回结构不一致（有时
data，有时result）？加个response_parser配置项，指定提取路径，如'data'或'result.data' - 开发阶段开启
debug => true，把原始请求/响应写进日志，别只打$res——看不到headers和status code，根本没法定位
RPC不是透明的，每个环节都要有“边界感”：协议转换在Client层，业务语义在Service层，错误处理策略在Controller或中间件里。越想省事越容易散落在各处，最后连谁该处理token过期都说不清。
