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

06.5.6.5 TCP、UDP 与 HTTP/WebSocket 服务

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.6 Swoole

06.5.6.5-001 如何创建一个 TCP Server?

一句话结论

用 Swoole\Server 绑定监听地址与端口,socket 类型指定 SWOOLE_SOCK_TCP,注册连接、接收、关闭回调后 start() 启动事件循环。

概念解释

TCP Server 面向长连接字节流,每个连接由整数 fd 标识。服务启动后监听端口,连接建立触发 Connect,数据到达触发 Receive,断开触发 Close。业务在回调中读取 $data 并通过 $server->send($fd, ...) 回写。回调参数签名与默认行为以官方文档为准。

原理流程

  1. 构造 Server,传入 host、port、模式与 TCP socket 类型。
  2. 注册 Connect/Receive/Close 回调。
  3. 调用 start() 进入事件循环。
  4. 连接事件按回调分发处理。

代码或图示

$server = new Swoole\Server('0.0.0.0', 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);

$server->on('Receive', function (Swoole\Server $server, int $fd, int $reactorId, string $data) {
    $server->send($fd, 'echo: ' . $data);
});

$server->start();

常见误区

  • 把 TCP 当消息边界明确的协议:TCP 是字节流,需自行处理粘包拆包。
  • 忘记 start():只注册回调不启动循环,服务不会监听端口。

追问

  • 监听地址怎么选?答:0.0.0.0 监听全部网卡,127.0.0.1 仅本机;生产绑定按网络拓扑配置。
  • 端口被占用如何排查?答:先确认端口未被其他进程占用,再核对防火墙与绑定地址。

06.5.6.5-002 TCP Server 的 Connect、Receive、Close 回调分别在什么时候触发?

一句话结论

Connect 在新连接建立时触发,Receive 在连接上有数据到达时触发,Close 在连接主动或被动断开时触发;回调参数携带 Server、fd 与 reactor 标识。

概念解释

Connect 拿到新连接 fd,可做连接登记与鉴权;Receive 可能多次触发,每次返回当前缓冲区读到的一段数据;Close 用于清理连接状态。连接异常断开(对端崩溃、网络中断)不一定立即感知,需配合心跳检测发现半开连接。回调参数类型与顺序以官方文档为准。

原理流程

  1. 三次握手完成,触发 Connect,登记 fd。
  2. 对端数据到达,触发 Receive,业务读取并处理。
  3. 连接关闭(主动关闭或异常),触发 Close,清理资源。
  4. 半开连接由心跳机制在空闲超时后判定断开。

代码或图示

$server->on('Connect', function (Swoole\Server $server, int $fd) {
    echo "connect fd={$fd}\n";
});

$server->on('Close', function (Swoole\Server $server, int $fd) {
    echo "close fd={$fd}\n";
});

常见误区

  • 以为一次 Receive 对应一条完整消息:字节流分段到达,需协议分包。
  • 在 Close 回调里假设对端正常关闭:异常断开同样触发 Close,原因需结合心跳与状态判断。

追问

  • reactorId 是什么?答:事件受理线程标识,用于排查事件归属;取值含义以版本为准。
  • 连接状态存哪里?答:按 fd 维护连接上下文表;进程内表与跨进程共享边界见内存表专题。

06.5.6.5-003 onReceive 的参数分别代表什么?

一句话结论

参数依次为 Server 实例、连接 fd、reactor 标识与收到的数据 $data;fd 标识连接,$data 是本次读到的字节片段,不保证是完整业务报文。

概念解释

$server 用于回写与连接操作;$fd 是当前连接编号,后续 send/close 都按 fd 定位;$reactorId 标识受理事件的 Reactor;$data 为本次接收片段。业务不能把单次 $data 当完整协议消息,需按分包规则拼接与切分。参数类型声明随版本可能调整,以文档为准。

原理流程

  1. 事件循环从连接缓冲区读出一段数据。
  2. 组装 Receive 回调参数:Server、fd、reactorId、data。
  3. 业务按协议缓冲拼接,判断是否得到完整报文。
  4. 处理完整报文,剩余片段保留到下一次 Receive。

代码或图示

$server->on('Receive', function (Swoole\Server $server, int $fd, int $reactorId, string $data) {
    echo "fd={$fd} reactor={$reactorId} bytes=" . strlen($data) . "\n";
    $server->send($fd, 'ok');
});

常见误区

  • 把 $data 长度当消息长度:本次读取量受缓冲区与触发时机影响。
  • 跨回调保存 $data 引用:字符串按值处理,后续片段需重新拼接。

追问

  • 如何判断报文完整?答:按固定头长度、EOF 分隔或空包协议分包;见协议分包题目。
  • 大数据包如何处理?答:配置最大包长并做流式拼接;超限包按协议丢弃或断开。

06.5.6.5-004 UDP 服务有什么无连接特性?

一句话结论

UDP 无连接:没有 Connect/Close 握手与断开过程,数据以数据包为单位到达 onPacket 回调,每个报文携带对端地址信息,服务端无需维护连接状态。

概念解释

UDP 不保证可靠交付、顺序与不重复,报文可能丢失或乱序。服务端一次监听端口即可接收来自不同地址的数据包,回调参数包含数据与客户端地址信息。适合上报、探测、广播等可容忍丢失的场景;需要可靠传输时应在应用层补确认与重传,或改用 TCP。

原理流程

  1. 构造 Server 时 socket 类型指定 SWOOLE_SOCK_UDP。
  2. 数据包到达端口,触发 Packet 回调。
  3. 回调从地址信息中取对端 IP 与端口,按需回包。
  4. 无连接生命周期概念,不维护 fd 连接表。

代码或图示

$server = new Swoole\Server('0.0.0.0', 9502, SWOOLE_PROCESS, SWOOLE_SOCK_UDP);

$server->on('Packet', function (Swoole\Server $server, string $data, array $clientInfo) {
    $server->sendto($clientInfo['address'], $clientInfo['port'], 'ack');
});

$server->start();

常见误区

  • 用 TCP 回调模型理解 UDP:没有 Connect/Close,也没有连接 fd 复用概念。
  • 假设 UDP 报文可靠到达:丢包、乱序、重复需应用层处理。

追问

  • $clientInfo 包含哪些字段?答:通常含地址与端口;完整字段以官方文档为准,待确认。
  • UDP 大包限制?答:受 MTU 与报文长度限制,超大数据需分片;具体阈值以网络环境为准。

06.5.6.5-005 UDP 与 TCP 在服务配置上有什么区别?

一句话结论

两者主要区别在 socket 类型常量与回调模型:TCP 用 Connect/Receive/Close 与 fd,UDP 用 Packet 回调与地址信息;连接维护、心跳与分包逻辑按协议特性分别设计。

概念解释

构造 Server 时通过 socket 类型选择协议。TCP 面向字节流,需要分包与心跳;UDP 面向数据报,每个包独立寻址。同一进程可监听多个端口与多种协议。配置项中连接数、心跳等面向 TCP 长连接的机制对 UDP 不直接适用,具体支持范围以文档为准。

原理流程

  1. 按协议选择 SWOOLE_SOCK_TCP 或 SWOOLE_SOCK_UDP。
  2. 注册对应回调组:TCP 连接回调或 UDP Packet 回调。
  3. 业务按协议语义处理数据与寻址。
  4. 多协议需求通过多端口监听实现。

代码或图示

$tcp = new Swoole\Server('0.0.0.0', 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);
$udp = new Swoole\Server('0.0.0.0', 9502, SWOOLE_PROCESS, SWOOLE_SOCK_UDP);

常见误区

  • 给 UDP 配置连接心跳:UDP 无连接,空闲判定模型不同。
  • 把 TCP 粘包方案套到 UDP:UDP 报文本身有边界,不存在字节流拼接问题。

追问

  • 同一进程能否同时提供 TCP 与 UDP?答:可通过多端口监听实现;具体接口与限制以官方文档为准。
  • 协议选择依据是什么?答:可靠性、顺序、报文大小与实时性要求;可靠交互优先 TCP,上报探测可用 UDP。

06.5.6.5-006 HTTP Server 如何创建,onRequest 回调结构是什么?

一句话结论

用 Swoole\HTTP\Server 监听端口,注册 onRequest 回调,回调接收请求对象与响应对象,读取请求信息并通过响应对象返回内容。

概念解释

HTTP Server 在常驻进程内解析 HTTP 报文,封装为 Request/Response 对象。回调每次请求执行一次(协程环境下在协程内运行)。响应必须显式结束(end),未结束的连接与内存会残留。请求方法、路径、头、参数等通过请求对象方法读取;响应状态码、头、Cookie 通过响应对象设置。

原理流程

  1. 构造 HTTP Server 并注册 Request 回调。
  2. 请求报文到达,解析为 Request 对象,创建 Response 对象。
  3. 回调读取请求参数,执行业务,写入响应。
  4. 调用 end 结束响应,连接进入后续复用或关闭流程。

代码或图示

$http = new Swoole\HTTP\Server('0.0.0.0', 9501);

$http->on('Request', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    $response->header('Content-Type', 'text/plain; charset=utf-8');
    $response->end('hello ' . $request->get['name'] ?? 'guest');
});

$http->start();

常见误区

  • 忘记调用 end:响应不结束,连接与缓冲资源残留。
  • 在回调返回后再写响应:响应对象生命周期随请求结束,延迟写入无效。

追问

  • HTTP Server 与 TCP Server 关系?答:HTTP 协议构建在 TCP 之上,扩展在内部完成报文解析;HTTP Server 提供高层 Request/Response 封装。
  • 回调是否在协程内?答:取决于 Server 协程开关配置;核对版本默认值,待确认。

06.5.6.5-007 HTTP 请求对象常用读取方式有哪些?

一句话结论

请求对象提供 GET/POST 数据、请求头、Cookie、方法、路径与原始报文等读取入口;属性与方法名以官方文档为准,读取时注意参数不存在的默认值处理。

概念解释

$request->get 对应查询参数,$request->post 对应表单参数,$request->header 存放请求头,$request->cookie 存放 Cookie;方法、路径、协议版本等有对应属性。原始 body 通过 rawContent 类方法获取。参数数组可能不存在对应键,读取时需判空,避免未定义键告警。

原理流程

  1. 扩展解析 HTTP 报文,填充请求对象属性。
  2. 业务按参数名读取 get/post/header/cookie。
  3. 缺失参数使用默认值或进入校验分支。
  4. 需要原始报文时读取 body 原始内容自行解析。

代码或图示

$http->on('Request', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    $name = $request->get['name'] ?? 'guest';
    $method = $request->server['request_method'] ?? '';
    $token = $request->header['authorization'] ?? '';
    $response->end("{$method} {$name} token=" . strlen($token));
});

常见误区

  • 直接取数组键不判空:参数缺失时产生告警或错误。
  • 混淆 header 键名大小写:头字段按解析后的键名读取,具体规范以实现为准。

追问

  • JSON body 怎么取?答:读取原始 body 后 json_decode;方法名与返回格式以文档为准。
  • 上传文件信息在哪里?答:请求对象的文件结构属性;字段结构按版本核对,待确认。

06.5.6.5-008 HTTP 响应对象常用写入方式有哪些?

一句话结论

响应对象提供状态码、响应头、Cookie 与报文结束写入入口;内容通过 end 一次性或分段写入,最终必须以 end 结束响应。

概念解释

status 设置状态码,header 设置响应头,cookie 写入 Cookie;write 可分段发送 body,end 发送剩余内容并结束响应。响应头需在 body 写入前设置。中文与编码通过 Content-Type 声明;长连接下响应结束后对象不再可用。方法签名与分段写入行为以官方文档为准。

原理流程

  1. 业务处理完成,先设置状态码与响应头。
  2. 必要时分段 write 输出 body。
  3. 调用 end 结束响应,提交报文。
  4. 响应对象生命周期结束,不可再写入。

代码或图示

$http->on('Request', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    $response->status(200);
    $response->header('Content-Type', 'application/json; charset=utf-8');
    $response->cookie('sid', 'demo-sid', time() + 3600);
    $response->end(json_encode(['ok' => true]));
});

常见误区

  • end 之后再写头或 body:响应已结束,写入无效。
  • 分段写入不设 Content-Length:依赖分块传输时需确认协议行为。

追问

  • 重定向怎么做?答:设置 3xx 状态码与 Location 头后 end;具体方法以文档为准。
  • 响应异常如何兜底?答:回调内 try/catch,异常分支写错误状态与报文,避免连接悬挂。

06.5.6.5-009 WebSocket Server 如何创建,有哪些核心回调?

一句话结论

WebSocket 服务基于 HTTP 握手升级,核心回调包括握手、连接打开、消息到达与连接关闭;服务端通过 push 向连接推送帧数据。

概念解释

WebSocket 先以 HTTP 请求完成 Upgrade 握手,成功后连接升级为长连接,双方可持续双向推送。onOpen 在握手成功后触发,onMessage 收到客户端帧时触发,onClose 断开时触发;自定义握手可通过 Handshake 回调处理。回调名、参数与帧类型常量以官方文档为准。

原理流程

  1. 构造 WebSocket Server,注册 Open/Message/Close 回调。
  2. 客户端发起 HTTP Upgrade 请求,完成握手。
  3. 握手成功触发 Open,连接进入双向通信状态。
  4. 客户端帧到达触发 Message,服务端处理后可 push 推送;断开触发 Close。

代码或图示

$ws = new Swoole\WebSocket\Server('0.0.0.0', 9501);

$ws->on('Open', function (Swoole\WebSocket\Server $server, Swoole\HTTP\Request $request) {
    $server->push($request->fd, 'connected');
});

$ws->on('Message', function (Swoole\WebSocket\Server $server, Swoole\WebSocket\Frame $frame) {
    $server->push($frame->fd, 'echo: ' . $frame->data);
});

$ws->start();

常见误区

  • 把 WebSocket 当普通 HTTP 短连接:握手后是长连接,需管理连接生命周期与心跳。
  • 忽略帧类型:文本、二进制、控制帧处理方式不同,需按帧类型区分。

追问

  • 握手失败如何处理?答:在握手回调中按校验结果返回响应;握手失败连接不进入 Open 阶段。
  • $frame 包含哪些信息?答:通常含 fd、数据与帧 opcode;完整字段以官方文档为准。

06.5.6.5-010 WebSocket 握手过程是怎样的?

一句话结论

握手是一次带 Upgrade 头的 HTTP 请求:客户端声明协议升级,服务端校验后返回 101 状态,连接切换为 WebSocket 协议,后续按帧传输。

概念解释

握手阶段仍走 HTTP 报文:请求携带 Upgrade、Connection 与协议版本/密钥头;服务端校验来源、协议版本与密钥,通过后返回 101 Switching Protocols。握手成功后 Open 回调触发,连接不再是普通 HTTP 请求。自定义鉴权可放在握手阶段完成,失败直接拒绝升级。

原理流程

  1. 客户端发 HTTP 请求,携带 WebSocket Upgrade 相关头。
  2. 服务端解析头,校验 Origin、协议版本与密钥。
  3. 校验通过返回 101 与协议响应头。
  4. 连接升级完成,触发 Open,进入帧通信阶段。

代码或图示

$ws->on('Handshake', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    // 握手校验:来源与参数;通过后由扩展完成升级,具体响应接口以文档为准
    $response->status(101);
    return true;
});

常见误区

  • 握手阶段按普通请求处理响应:升级响应有专用头与状态约定。
  • 把鉴权放到 Message 阶段:握手阶段拒绝更省连接资源。

追问

  • 握手头有哪些关键字段?答:Upgrade、Connection、Sec-WebSocket-Key 与协议版本等;字段名按 WebSocket 协议规范核对。
  • 跨域握手如何控制?答:校验 Origin 头,来源不允许则拒绝升级;策略按安全要求设计。

06.5.6.5-011 WebSocket 帧有哪些类型?

一句话结论

帧分为文本、二进制与控制帧(关闭、Ping、Pong)等类型;服务端按 opcode 区分业务数据与控制报文,业务消息主要处理文本与二进制帧。

概念解释

帧是 WebSocket 通信单位,头部带 opcode 标识类型。文本帧承载字符串,二进制帧承载原始字节;控制帧用于连接关闭与心跳保活。扩展对帧的解析、分片与合并处理在内部完成,业务拿到的 Frame 对象已含数据与类型。分片帧的处理行为以版本实现为准。

原理流程

  1. 对端发送帧,服务端解析头部 opcode 与载荷。
  2. 按类型分发:文本/二进制进入业务处理,控制帧走保活或关闭流程。
  3. 业务处理后用 push 发送响应帧。
  4. 关闭帧触发 Close 回调清理连接。

代码或图示

$ws->on('Message', function (Swoole\WebSocket\Server $server, Swoole\WebSocket\Frame $frame) {
    // 帧类型常量名与取值以官方文档为准
    if ($frame->opcode === WEBSOCKET_OPCODE_TEXT) {
        $server->push($frame->fd, 'text: ' . $frame->data);
    }
});

常见误区

  • 假设所有消息都是文本:二进制帧需按字节处理,不能直接当字符串。
  • 忽略 Ping/Pong 处理:心跳保活依赖控制帧响应机制。

追问

  • 分片消息如何处理?答:分片重组由扩展/协议层完成;业务是否收到完整帧以版本实现为准,待确认。
  • 服务端主动 Ping 怎么做?答:通过服务端提供的推送/心跳接口;方法名与参数以文档为准。

06.5.6.5-012 什么是粘包与拆包,协议分包有哪几种方式?

一句话结论

TCP 字节流没有消息边界,一段数据可能包含多条消息(粘包)或一条消息被拆分(拆包);服务端通过长度字段、EOF 分隔或空包协议切分完整报文。

概念解释

分包方式常见三类:按固定包头长度字段解析包体长度(open_length_check);按结尾 EOF 字符分隔(open_eof_check);空包协议以特殊包标记边界。配置包含最大包长、长度类型与偏移等参数。选错分包方式会导致报文拼接错误或解析卡死。具体配置项名称与默认值以官方文档为准。

原理流程

  1. 在服务配置中声明协议分包方式与参数。
  2. 扩展按规则在 Receive 前缓冲与切分数据。
  3. 完整报文就绪后回调业务;不完整片段继续缓冲。
  4. 超过最大包长按配置策略处理,避免内存膨胀。

代码或图示

$server->set([
    'open_length_check' => true,
    'package_length_type' => 'N',
    'package_length_offset' => 0,
    'package_body_offset' => 4,
    'package_max_length' => 1024 * 1024,
]);

常见误区

  • 直接把单次 Receive 数据当完整消息:未做分包时粘包拆包必然发生。
  • 不设最大包长:恶意或异常大包会撑爆缓冲区内存。

追问

  • 长度字段各参数含义?答:长度类型(字节序/宽度)、长度偏移与包体偏移配合解析;具体取值规则以文档为准。
  • EOF 协议适合什么场景?答:报文不含 EOF 字符、文本类协议;二进制协议优先长度字段方式。

06.5.6.5-013 心跳检测如何配置,解决什么问题?

一句话结论

心跳检测按间隔检查空闲连接,超过空闲时间未通信的连接被判定断开并触发 Close;用于发现半开连接,释放僵死连接占用的 fd 与内存。

概念解释

TCP 半开连接(对端断电、网络中断)不会及时通知服务端,连接一直占用资源。心跳机制周期性扫描连接列表,空闲超时的连接被关闭回收。配置包含检测间隔与空闲时长;应用层也可通过 Ping/Pong 帧保活。具体配置项名称、单位与默认值以官方文档为准,待确认。

原理流程

  1. 配置心跳检测间隔与空闲超时阈值。
  2. 周期扫描连接最近活跃时间。
  3. 超过阈值未通信的连接标记超时。
  4. 关闭连接并触发 Close 回调清理状态。

代码或图示

$server->set([
    'heartbeat_check_interval' => 30,
    'heartbeat_idle_time' => 60,
]);

常见误区

  • 以为心跳能修复不可达连接:它只是发现并回收僵死连接,不保证链路恢复。
  • 心跳间隔设得过短:扫描与心跳报文开销上升;过长则僵死连接占用时间久。

追问

  • 心跳与 WebSocket Ping/Pong 关系?答:服务端空闲扫描是连接层回收机制;Ping/Pong 是协议层保活帧,两者配合使用。
  • 如何记录连接活跃时间?答:在 Receive/Message 回调中更新连接状态,配合扫描判定。

06.5.6.5-014 连接 fd 的含义与连接列表如何管理?

一句话结论

fd 是进程内连接编号,用于定位连接并发送数据;服务端维护连接列表,可判断连接是否存在、遍历连接做广播或状态清理。

概念解释

每个连接在当前进程内分配整数 fd,send、push、close 都按 fd 定位。连接建立入表,断开出表;可通过连接判断接口检查 fd 是否仍有效。fd 编号进程内有效,不复用为业务身份。连接列表接口名与返回结构以官方文档为准。

原理流程

  1. 连接建立,分配 fd 并入连接表。
  2. 业务按 fd 发送数据或查询状态。
  3. 连接断开,从表中移除。
  4. 广播时遍历有效连接列表逐个推送。

代码或图示

$server->on('Open', function (Swoole\WebSocket\Server $server, Swoole\HTTP\Request $request) {
    $fd = $request->fd;
    var_dump($server->isEstablished($fd)); // 连接是否有效,方法名以文档为准
});

常见误区

  • 把 fd 持久化为业务用户标识:fd 会随连接断开回收复用。
  • 不判断连接有效性就推送:已断开 fd 推送失败,需处理返回值。

追问

  • 跨 Worker 连接如何推送?答:连接分布在不同进程,跨进程推送机制以扩展接口为准;见进程间通信题目。
  • 连接状态存哪里?答:进程内按 fd 维护上下文;跨进程共享状态用 Table,见内存表专题。

06.5.6.5-015 主动推送与广播如何实现?

一句话结论

单连接推送按 fd 调用推送接口;广播遍历连接列表逐个发送;跨进程连接推送需借助服务端提供的跨进程机制或共享连接索引。

概念解释

推送接口把数据写入指定连接缓冲区。单播用于定向消息,广播用于全员通知。连接分布在多个 Worker 进程时,本进程列表只包含本进程连接;跨进程广播需要扩展支持的跨进程推送,或维护共享 fd 索引并协调各进程发送。发送失败(连接已断开)需跳过并清理状态。

原理流程

  1. 确定目标:单个 fd、一组 fd 或全部连接。
  2. 单播直接按 fd 推送。
  3. 广播遍历连接列表逐个发送,跳过无效 fd。
  4. 跨进程场景按扩展机制或共享索引协调推送。

代码或图示

function broadcast(Swoole\WebSocket\Server $server, string $message): void
{
    foreach ($server->connections as $fd) {
        if ($server->isEstablished($fd)) {
            $server->push($fd, $message);
        }
    }
}

常见误区

  • 假设遍历到的连接都属于当前进程:多进程部署下需确认列表范围与跨进程推送能力。
  • 推送失败不处理:断开连接残留会导致后续推送持续报错。

追问

  • 大广播如何避免阻塞?答:控制单条消息大小与推送节奏,观察缓冲区积压;慢消费者单独隔离。
  • 推送数据类型?答:文本与二进制按帧类型区分;接口参数以文档为准。

06.5.6.5-016 与 Nginx 反向代理配合需要注意什么?

一句话结论

Nginx 转发到 Swoole 服务时需正确传递协议头、真实客户端地址与 WebSocket Upgrade 头;否则服务端拿到的是代理信息,长连接升级可能失败。

概念解释

反代场景下 Swoole 看到的对端是 Nginx,需通过转发头获取真实 IP;HTTP 转发需保留 Host 与协议头,WebSocket 需透传 Upgrade 与 Connection 头。代理超时配置要与长连接保活策略匹配,避免空闲连接被代理提前断开。Nginx 配置细节不属于本章节展开范围,只说明服务端需要识别的头信息。

原理流程

  1. Nginx 监听外部端口,按规则转发到 Swoole 端口。
  2. 转发时携带客户端真实地址与原始请求头。
  3. WebSocket 升级头透传,完成握手。
  4. 服务端从约定头读取真实客户端信息。

代码或图示

$http->on('Request', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    $realIp = $request->header['x-forwarded-for'] ?? $request->header['remote_addr'] ?? 'unknown';
    $response->end("client={$realIp}");
});

常见误区

  • 直接取连接对端地址当客户端 IP:反代后该地址是 Nginx。
  • 不透传 Upgrade 头:WebSocket 握手无法升级,连接按普通 HTTP 处理。

追问

  • 代理超时如何配合心跳?答:代理空闲超时应大于服务端心跳周期,避免连接被代理先断开;具体数值按环境调整。
  • 真实 IP 头可信吗?答:需在代理层覆盖/校验相关头,防止客户端伪造;安全策略按部署架构设计。

06.5.6.5-017 同一进程如何监听多个端口或多种协议?

一句话结论

Server 可通过端口监听接口在同一进程追加多个监听端口,分别绑定 TCP、UDP 或 HTTP 协议;各端口可注册独立回调,适合同进程提供多种服务入口。

概念解释

主 Server 确定基础模型后,可调用端口添加接口监听额外地址端口,返回端口对象并为其注册回调。多端口共享进程内 Worker 与资源,协议处理按端口区分。具体添加接口名、回调绑定方式与限制以官方文档为准,待确认。

原理流程

  1. 创建主 Server 并配置基础参数。
  2. 调用监听接口追加端口与协议类型。
  3. 为各端口注册对应协议回调。
  4. 启动后各端口事件按回调分别处理。

代码或图示

$server = new Swoole\Server('0.0.0.0', 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);

$udpPort = $server->listen('0.0.0.0', 9502, SWOOLE_SOCK_UDP);
$udpPort->on('Packet', function (Swoole\Server $server, string $data, array $info) {
    $server->sendto($info['address'], $info['port'], 'ack');
});

常见误区

  • 多端口回调互相覆盖:各端口回调需分别绑定,注意回调注册范围。
  • 假设多协议无需区分解析:TCP/UDP/HTTP 报文处理逻辑不同,回调内分开实现。

追问

  • 多端口共享 Worker 吗?答:端口与进程模型的关系以实现为准;共享 Worker 时注意不同协议负载相互影响。
  • 端口监听失败如何排查?答:检查端口占用、绑定地址与权限;错误信息记录到启动日志。

06.5.6.5-018 自定义协议服务端解析需要注意什么?

一句话结论

自定义协议需明确报文结构、字节序、长度字段与边界规则,配合分包配置切分报文;解析失败、超限与非法帧要有明确处理策略,避免缓冲区膨胀或连接卡死。

概念解释

协议设计包含魔数/版本、长度字段、命令类型、载荷与校验位。服务端按规则解析头部、校验长度与完整性,再分发业务。未识别命令、长度非法、校验失败应记录日志并按策略断开或丢弃。二进制协议注意大小端与字节序;文本协议注意编码与分隔符。

原理流程

  1. 定义协议格式:头部字段、长度位置、载荷编码。
  2. 配置分包规则,保证完整报文进入回调。
  3. 解析头部并校验长度、校验位与命令。
  4. 合法报文进入业务;异常报文记录并按策略处理。

代码或图示

$server->on('Receive', function (Swoole\Server $server, int $fd, int $reactorId, string $data) {
    $header = substr($data, 0, 4);
    $length = unpack('N', $header)[1] ?? 0;
    if ($length <= 0 || $length > 65535) {
        $server->close($fd);
        return;
    }
});

常见误区

  • 协议长度字段与分包配置不一致:解析错位导致后续报文全部错乱。
  • 异常帧直接忽略不记录:线上难以定位客户端协议问题。

追问

  • 字节序如何处理?答:pack/unpack 格式符明确大小端;跨语言客户端需对齐字节序约定。
  • 协议版本兼容怎么做?答:头部带版本号,解析时按版本分支处理,旧版本消息降级或拒绝。

06.5.6.5-019 连接超时与空闲连接回收如何处理?

一句话结论

长连接需设置空闲超时与心跳回收,避免僵死连接占用 fd;主动关闭超时连接时清理业务上下文,保证资源随连接释放。

概念解释

连接可能因客户端异常、网络分区长期挂着不通信。除服务端心跳扫描外,业务侧可为连接设置超时状态,超时未活动则主动关闭并清理会话数据。响应超时、读写超时按协议场景分别控制。超时配置项与接口以官方文档为准;超时后未释放的对象需在 Close 回调兜底清理。

原理流程

  1. 记录每个连接的最近活跃时间与会话上下文。
  2. 心跳/定时器扫描超时连接。
  3. 超时连接主动关闭,触发 Close 回调。
  4. Close 回调清理业务上下文与关联资源。

代码或图示

$server->on('Close', function (Swoole\Server $server, int $fd) {
    // 清理按 fd 保存的会话上下文
    echo "cleanup fd={$fd}\n";
});

常见误区

  • 只在 Connect 分配资源,不在 Close 清理:僵死连接携带的上下文持续占用内存。
  • 超时只断开连接不清业务状态:会话数据残留到进程重启。

追问

  • 读写超时在哪里设置?答:连接/客户端超时配置项按官方文档核对;服务端空闲回收以心跳配置为主。
  • 如何区分正常闲置与异常断开?答:结合心跳帧、最近活跃时间与对端关闭事件综合判断。

06.5.6.5-020 服务端常见问题:响应未结束、fd 复用与跨 Worker 推送如何排查?

一句话结论

响应悬挂先查 end/关闭调用是否缺失;fd 异常先核对连接有效性与清理路径;跨 Worker 推送先确认连接分布与跨进程推送机制,再排查共享索引是否过期。

概念解释

响应未结束表现为连接悬挂、内存累积;fd 复用与错误推送表现为消息发到错误连接;跨 Worker 推送失败多为只遍历了本进程连接。排查按现象定位到协议层、连接管理层或进程通信层,记录版本、配置与复现步骤;不确定行为标注待确认。

原理流程

  1. 响应悬挂:检查回调是否所有分支都结束响应,是否有异常分支未收尾。
  2. fd 异常:核对 Close 清理、连接判断接口与推送返回值。
  3. 跨进程推送:确认连接列表范围,使用扩展跨进程推送或共享索引。
  4. 最小复现后对照文档修正回调与配置。

代码或图示

$http->on('Request', function (Swoole\HTTP\Request $request, Swoole\HTTP\Response $response) {
    try {
        // 业务处理
        $response->end('ok');
    } catch (Throwable $e) {
        $response->status(500);
        $response->end('error'); // 异常分支也必须结束响应
    }
});

常见误区

  • 异常分支漏写 end:错误请求悬挂住连接。
  • 推送前不判断连接状态:已断开 fd 产生无效推送与报错。

追问

  • 如何定位悬挂连接?答:统计未结束响应数与连接存活时长,结合回调耗时日志;具体统计接口以版本为准。
  • 跨进程推送能力如何确认?答:查官方文档 Server 推送接口的进程范围;不支持时用共享 fd 索引配合各进程自推送。