必须。因为 think\swoole\rpc\server\Dispatcher 的 prepareServices 方法硬性依赖接口定义进行反射注册，不写 interface 则服务无法被加载进 RPC 调度器。
ThinkPHP8 + Swoole 的 RPC 服务必须写 interface 吗？
必须。不是为了“规范”，而是 think\swoole\rpc\server\Dispatcher 的 prepareServices 方法硬性依赖接口定义来反射注册服务。不写 UserInterface，服务根本不会被加载进 RPC 调度器。
实操建议：
- 接口里只声明方法签名，不写实现；类用
implements继承它，再具体实现 - 接口命名建议统一前缀，比如
UserRpcInterface，避免和普通业务接口混淆 - 如果已有类没接口，别强行改——直接新建 interface + 新实现类，旧逻辑保留供本地调用
tinywan/rpc 在 Webman 中怎么传复杂参数？
它默认用 JSON 传输，但 args 字段是数组嵌套结构，容易漏一层。常见错误是把参数直接塞进 args，结果服务端收到的是 [[...]]（双重数组）。
正确写法：
立即学习“PHP免费学习笔记（深入）”；
- 客户端
$request['args']必须是「一维数组」，每个元素是一个调用参数（即使只有一个），例如：['args' => [['uid' => 123, 'tags' => ['a', 'b']]]] - 服务端方法签名要匹配这个结构，比如
public function update($data)，其中$data就是['uid' => 123, 'tags' => [...]] - 别在服务端再手动
json_decode($data)—— tinywan 已自动反序列化
gRPC for PHP 遇到 Call to undefined function grpc\grpc_init()
这不是代码写错了，是扩展根本没装成功。PHP gRPC 扩展依赖两个独立组件：grpc 和 protobuf，缺一不可，且版本需严格对齐（比如 grpc v1.64.x 要求 protobuf v4.25.x）。
排查步骤：
- 运行
php -m | grep -E 'grpc|protobuf'，确认两者都出现在输出里 - 检查
phpinfo()页面中grpc模块是否显示 “enabled”，并核对grpc.version值 - 若用 Docker，确保基础镜像已预装对应版本，而不是仅
pecl install grpc—— 容器里常缺libgrpc-dev编译依赖 -
protoc命令行工具也要安装，否则protoc --php_out=.会失败
原生 Socket RPC 怎么避免粘包？
用 \n 分隔是最简单有效的方案，但前提是双方严格遵守：发完数据必须加换行，收端必须按行读取（fgets() 或 stream_get_line()），不能用 fread() 盲读。
关键细节：
- 服务端
socket_read()后，必须用rtrim($data, "\n")清掉结尾换行，否则json_decode()会失败 - 客户端发送前，确保 JSON 不含未转义的换行符（
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_LINE_TERMINATORS） - 别用
socket_write()后立刻socket_close()—— TCP 是全双工，关连接前得等服务端回包
跨语言 RPC 最容易被忽略的点是协议头协商：PHP 服务端用 Protobuf，Java 客户端却用 JSON over HTTP，这种组合看似能通，实际会在字段类型、空值处理、时间戳格式上持续出问题。定协议时，第一件事不是写代码，是签一份 .proto 或接口契约文档。
