06.5.6.11 信号处理与热重启
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.6 Swoole
06.5.6.11-001 Swoole 服务进程对哪些信号默认有响应?
一句话结论
Master 进程默认监听停止信号(SIGTERM/SIGINT)与重载信号(SIGUSR1 一类),用于触发优雅关闭与平滑重启;具体信号编号、默认绑定与版本差异需以官方文档和本机 php --ri swoole 核对,不确定处标注待确认。
概念解释
信号是操作系统向进程发送的异步通知。Swoole 服务在 Master 层接管部分信号:停止类信号触发关闭流程,重载类信号触发 Worker 平滑重启。Worker/Task Worker 不独立响应这些管理信号,退出由 Master 协调。自定义进程可以通过信号注册接口绑定自己的回调。信号默认行为、被覆盖的信号集合随版本与运行模式不同,不能凭记忆写生产脚本。
原理流程
- 服务启动后,Master 进程在事件循环中注册信号监听。
- 外部(shell、容器编排、监控脚本)向 Master 发送信号。
- 事件循环检测到信号到达,分发到对应处理流程。
- Master 按信号类型执行关闭或协调 Worker 重启。
代码或图示
# 查看服务主进程 PID 与信号关联(Linux 环境)
ps -eo pid,ppid,cmd | findstr swoole
# 向 Master 发送重载/停止信号前,先核对当前版本信号约定
常见误区
- 以为 Worker 自己响应 SIGTERM 退出:管理信号由 Master 受理并协调,Worker 按收尾流程退出。
- 把旧版本信号表套到新版本:信号绑定与默认行为需对照所装版本文档核对。
追问
- 如何确认本机版本监听哪些信号?答:查官方文档信号章节;结合测试环境
kill -<信号>观察进程反应,记录版本与结果。 - 信号可以在代码里覆盖默认处理吗?答:自定义进程可用信号注册接口设置回调;Server 管理信号的覆盖范围受限,以版本实现为准,待确认。
06.5.6.11-002 Master 与 Worker 各自处理哪些信号?
一句话结论
Master 负责受理停止、重载等管理信号并编排进程生命周期;Worker 与 Task Worker 按 Master 指令收尾退出,一般不直接绑定管理信号;自定义进程可自行注册信号回调。
概念解释
进程模型分工在 Server 模式章节已展开,本题聚焦信号落点:Master 是信号汇聚点,收到信号后决定关闭还是 reload,再通知各 Worker。Worker 收到退出指令后执行请求收尾、资源释放后退出。这样分层避免多个进程各自响应信号导致状态混乱。自定义 Process 脱离 Server 编排,需要自己处理信号才能优雅退出。
原理流程
- 管理信号发送到 Master 进程。
- Master 判断信号类型,生成关闭或重载指令。
- 指令下发给对应 Worker/Task Worker,进入收尾流程。
- Worker 退出后由 Master 回收;重载场景按配置拉起新 Worker。
代码或图示
外部信号 → Master(受理与编排)
├─ 停止信号 → 通知全部 Worker 收尾退出 → Master 退出
├─ 重载信号 → 协调旧 Worker 退出、新 Worker 拉起
└─ Worker / Task Worker:按指令收尾,不独立响应管理信号
常见误区
- 在 Worker 回调里注册 SIGTERM 回调替代 Master 收尾:Worker 收到的是 Master 指令,信号回调行为与版本相关。
- 自定义进程与 Server Worker 混用信号处理:两者生命周期管理路径不同,需分别设计。
追问
- Manager 进程在信号流程中做什么?答:Manager 按职责监控与回收 Worker;部分模式下职责由 Master 侧承担,版本边界待确认。
- 信号回调在哪一层线程执行?答:信号由事件循环在进程内分发,回调执行上下文与协程环境需按版本核对,待确认。
06.5.6.11-003 SIGTERM 与 SIGINT 的语义是什么?
一句话结论
两者都属于停止服务的信号:SIGTERM 请求优雅终止,SIGINT 通常对应终端 Ctrl+C 中断;Swoole 收到后进入优雅关闭流程,等待在跑请求收尾,而不是立即强杀。
概念解释
操作系统默认语义:SIGTERM 是请求终止(可被捕获处理),SIGINT 是键盘中断。Swoole 服务把停止类信号接入自身关闭流程:先停止接收新连接/请求,等待在跑任务完成或超时,再回收资源退出。信号本身不携带“强制结束”语义,强制中断需发送 SIGKILL(不可捕获)。
原理流程
- 收到 SIGTERM/SIGINT,Master 进入关闭流程。
- 停止接纳新请求,通知各 Worker 收尾。
- Worker 等待在跑请求/任务完成,释放连接与池资源。
- 收尾完成或超时后进程退出,Master 随后退出。
代码或图示
# Linux:优雅停止服务(先确认 Master PID)
kill -TERM <master-pid>
# 终端前台运行时 Ctrl+C 发送 SIGINT
# 超时未退出才考虑 SIGKILL:kill -9 <pid>
常见误区
- 把 SIGTERM 当成立即杀死:它走优雅关闭路径,请求收尾期间进程仍存活。
- 停止后立刻发 SIGKILL:正在收尾的连接与事务被中断,可能产生半截写入。
追问
- 优雅关闭等待多久?答:由收尾超时控制,超时后强制结束;超时配置项名称与默认值以官方文档为准,待确认。
- SIGKILL 能被捕获吗?答:不能。SIGKILL 直接终止进程,进程来不及释放资源,只作为最后兜底手段。
06.5.6.11-004 SIGUSR1 在 Swoole 中承担什么用途?
一句话结论
SIGUSR1 一类用户自定义信号在 Swoole 中常用于触发平滑重启(reload):不退出 Master,只协调 Worker/Task Worker 重建;是否同时绑定其他动作、是否有 SIGUSR2 分工,需按版本核对,标注待确认。
概念解释
用户信号由程序自定义语义。Swoole 重载流程绑定到用户信号:发送后 Master 协调旧 Worker 逐步退出、拉起新 Worker,加载最新代码与配置。重载不重启 Master 与事件循环,连接监听保留。脚本、容器编排中常把重载命令映射到该信号。不同版本信号与重载的绑定关系可能调整,上线前必须在目标版本验证。
原理流程
- 部署脚本/编排器向 Master 发送重载信号或调用 reload 接口。
- Master 识别为重载请求,进入平滑重启流程。
- 旧 Worker 逐步收尾退出,新 Worker 按配置拉起。
- 全部替换完成后服务继续监听,Master 保持运行。
代码或图示
// 代码内触发重载的接口形式;方法名与行为以官方文档为准
$server->reload(); // 平滑重启 Worker / Task Worker
常见误区
- 以为重载会重启 Master:Master 与监听 socket 保持,重建的是 Worker 进程。
- 跨版本照搬信号编号:信号绑定可能调整,应以文档与实测为准。
追问
- reload 与代码内
$server->reload()是同一流程吗?答:信号与接口最终进入同一协调流程;触发入口不同,内部行为以版本实现为准。 - SIGUSR2 有约定用途吗?答:版本间存在差异,未在文档明确时不要自行约定脚本依赖,待确认。
06.5.6.11-005 reload(平滑重启)与 restart(整体重启)有什么区别?
一句话结论
reload 不退出 Master,只替换 Worker/Task Worker,保留监听与事件循环,用于更新代码;restart 是整个服务进程树停止后重新拉起,Master、监听、内存状态全部重建,用于配置变更、扩展升级或 reload 无法解决的问题。
概念解释
两者触发场景不同:PHP 代码文件改动后,常驻进程需 reload 让新 Worker 加载新代码;监听端口、Master 结构、运行时配置不变。restart 走完整停止与启动流程:旧进程树优雅退出,新进程重新初始化。reload 不能改变 Master 层配置、扩展编译参数与进程模型;这类变更必须整体重启。
原理流程
- reload:Master 保留 → 旧 Worker 逐个收尾退出 → 新 Worker 拉起 → 服务继续。
- restart:停止信号走完关闭流程 → 进程树退出 → 启动脚本重新拉起服务。
- 代码更新优先 reload;配置/扩展/模型变更走 restart。
- 无法判断变更层级时,按版本文档确认 reload 生效范围。
代码或图示
reload:Master 存活,Worker 替换;适合 PHP 业务代码更新
restart:进程树全部停止再启动;适合配置、扩展、进程模型、端口变更
判断标准:变更是否只发生在 Worker 加载的业务代码层
常见误区
- 改了
php.ini或扩展配置后只 reload:Master 层配置不随 Worker 重建生效,必须 restart。 - 把 reload 当万能发布手段:内存常驻状态、静态缓存、连接池在 reload 后按新 Worker 重建,需评估影响。
追问
- reload 后静态缓存会清空吗?答:旧 Worker 内存随进程退出销毁,新 Worker 重新初始化;跨 Worker 共享的 Table 一类共享内存是否保留需按组件确认。
- 什么情况下 reload 不生效?答:代码缓存加载在 Master 层、opcache 未刷新、变更在非 Worker 执行路径;结合版本机制排查。
06.5.6.11-006 平滑重启时已有连接如何处理?
一句话结论
平滑重启过程中,旧 Worker 处理完手上的连接与请求后退出,监听 socket 由 Master 保留并交给新 Worker;进行中的长连接是否被断开取决于关闭策略与超时配置,不能假设所有连接都无缝迁移。
概念解释
服务监听 fd 在 Master 层持有,reload 时不关闭。旧 Worker 上已建立的连接随进程退出而终止:短请求在收尾窗口内处理完即可;长连接(WebSocket、长轮询)在旧进程退出时断开,需要客户端重连或由新连接承接。优雅关闭策略尽量等待请求完成,超时未结束的连接按配置中断。连接本身不随进程迁移到新 Worker。
原理流程
- 收到 reload 指令,Master 保留监听 fd,停止向旧 Worker 分发新连接。
- 旧 Worker 处理完在跑请求,等待超时窗口内收尾。
- 旧 Worker 退出,其上未结束的连接断开。
- 新 Worker 拉起后承接新连接;断开的长连接由客户端重连。
代码或图示
监听 fd(Master 持有,reload 期间不关闭)
→ 新连接分发给新 Worker
→ 旧连接留在旧 Worker:收尾完成自然关闭,超时则中断
长连接提示:WebSocket / 流式连接需设计断线重连与会话恢复
常见误区
- 以为连接会被“移交”给新 Worker:进程地址空间与连接状态不跨进程迁移。
- 忽略长连接断开通知:发布窗口内在线 WebSocket 用户会掉线,需提前公告或分批发布。
追问
- 收尾等待多久算合理?答:对齐接口最大耗时与长连接容忍度;超时配置以版本文档为准,待确认。
- 如何降低发布掉线影响?答:分批 reload、前置预热新实例、客户端自动重连;网关层摘除旧实例后再重启。
06.5.6.11-007 reload 只重启 Worker 还是连 Master 一起?
一句话结论
reload 默认只重建 Worker 与 Task Worker,Master 进程继续运行;Master 加载的配置、扩展与事件循环不随 reload 重建,需要整体 restart 才能更换。
概念解释
分层重建是平滑重启的核心:Master 持有监听与全局结构,退出 Master 意味着服务端口短暂释放。reload 让业务执行单元换新,管理层保持。Task Worker 通常随 Worker 一并重建;是否有单独控制重载范围的接口/参数,以版本文档为准。判断 reload 是否覆盖某变更,先确认该变更由 Master 加载还是 Worker 加载。
原理流程
- Master 受理重载请求,自身不退出。
- 协调旧 Worker/Task Worker 收尾退出。
- 按配置拉起新 Worker/Task Worker,加载业务代码。
- Master 继续监听并把新连接分发给新 Worker。
代码或图示
reload 影响范围:
Master(监听、事件循环、Master 层配置)→ 保留
Worker / Task Worker(业务代码、请求态、连接池)→ 重建
restart 影响范围:整个进程树全部重建
常见误区
- 以为 reload 后所有内存状态都重置:Master 层与共享内存结构可能保留。
- 记混重载范围:Task Worker 是否一并重启需核对版本行为,待确认。
追问
- 能否只 reload Worker 不 reload Task Worker?答:部分版本提供重载范围控制,参数名与默认行为待确认;常规流程两者一并重建。
- Master 长期不重启有风险吗?答:Master 层内存增长需观测;必要时在低峰期整体 restart 轮换。
06.5.6.11-008 代码更新后为什么需要 reload,普通改文件不够吗?
一句话结论
常驻进程在启动时加载并保留代码状态,不会像 FPM 那样每个请求重新读取文件;改动后的 PHP 文件要被新 Worker 加载,必须通过 reload 重建进程,或配合 opcode 缓存刷新机制生效。
概念解释
FPM 每请求由进程重新执行脚本,文件改动自然生效。Swoole Worker 常驻内存,代码、类定义、静态状态在进程生命周期内保留;文件被修改后,旧 Worker 内存中的类与函数仍是旧版本。reload 拉起新 Worker 时重新包含文件。若开启 opcode 缓存,还需确认缓存是否按文件变更自动刷新,否则 reload 后仍跑旧字节码。
原理流程
- 编辑磁盘上的 PHP 文件。
- 旧 Worker 内存中类定义与函数保持旧版本。
- reload 后新 Worker 重新包含文件,加载新代码。
- 核对 opcode 缓存配置,确认变更不被旧缓存遮蔽。
代码或图示
# Linux:确认 opcode 缓存与重验证策略(CLI 场景)
php -i | findstr /i opcache
# 代码发布后按部署流程触发 reload,再用版本探针接口验证运行版本
常见误区
- 改完文件直接看线上行为:旧 Worker 未重建,跑的仍是内存中旧代码。
- 忽略 opcode 缓存:文件时间戳/校验策略未刷新时,新文件仍被旧字节码覆盖。
追问
- 如何验证线上跑的是新版本?答:在探针接口返回构建版本号/代码标识,发布后对比各 Worker 返回。
- 代码包含在 Master 回调里怎么办?答:Master 加载的路径改动 reload 不覆盖,需 restart;先梳理代码在哪个进程上下文执行。
06.5.6.11-009 优雅退出的流程与超时控制是怎样的?
一句话结论
优雅退出按“停止接新请求 → 等待在跑任务收尾 → 释放资源 → 进程退出”执行,并设置等待超时;超时后仍未结束的任务按强制流程中断,避免进程挂死不退出。
概念解释
收尾流程需要给在跑请求、异步任务、事务与连接释放留出时间,但不能无限等待。超时控制防止慢请求/挂起协程阻塞关闭:窗口内完成的正常退出,超时未完成的记录中断并强制结束。超时配置项名称、默认值与可配置层级以版本文档为准,标注待确认。业务侧在退出回调中做必要清理:关连接池、落盘缓冲、通知下游。
原理流程
- 进程收到退出指令,停止接收新请求与新任务。
- 等待在跑协程/任务完成,逐批回收连接与资源。
- 超过收尾超时:中断未结束任务,记录告警。
- 资源释放完成,进程退出。
代码或图示
停止接纳新请求
→ 等待在跑请求 / 任务收尾(超时计时开始)
→ 释放连接池、定时器、缓冲数据
→ 收尾完成退出;超时未完成 → 强制中断并记录
常见误区
- 退出流程里再发起新的远程调用:收尾阶段下游可能已不可用,应只做本地必要清理。
- 不设超时:挂起协程或慢任务让进程永远不退出,编排器反复重试停止。
追问
- 收尾超时在哪配置?答:Server 配置项或进程退出参数;名称与默认值查官方文档,待确认。
- 超时中断的任务如何补偿?答:任务状态持久化,退出前记录未完成标识;重启后由补偿流程扫描处理。
06.5.6.11-010 自定义进程如何注册信号处理?
一句话结论
自定义 Process 可通过扩展提供的信号注册接口绑定信号回调,在进程循环内处理停止、重载等信号;回调注册时机、信号可绑定集合与协程上下文以版本文档为准,标注待确认。
概念解释
Server 的管理信号由 Master 编排,自定义进程独立于该体系:需要自己监听 SIGTERM 等信号才能优雅退出,否则收到默认信号行为后直接终止、来不及清理。信号回调在事件循环/进程循环中被调用;在回调内做重 IO 或长任务同样会阻塞循环。信号注册接口通常以进程实例或静态方法形式提供,具体签名需核对版本。
原理流程
- 创建自定义进程,在进程回调内注册信号监听。
- 循环运行业务逻辑或事件等待。
- 信号到达时执行注册回调:设置退出标志、释放资源。
- 循环检测退出标志后正常结束进程。
代码或图示
use Swoole\Process;
$proc = new function () {
Process::signal(SIGTERM, function () {
echo "custom process received SIGTERM, prepare exit\n";
// 清理资源、落盘缓冲,然后退出循环
});
// 业务循环:检测退出标志后 break
};
// 进程启动与参数按官方文档编写,接口名待确认
常见误区
- 自定义进程不注册停止信号:被默认行为直接杀掉,连接与缓冲来不及释放。
- 信号回调里跑长任务:阻塞循环,其他信号与事件无法处理。
追问
- 信号回调与协程环境是什么关系?答:取决于进程是否在协程上下文运行;回调内 IO 是否协程化需按版本核对,待确认。
- 一个进程能注册多个信号吗?答:可以分别注册不同信号回调;具体可绑定的信号集合以扩展实现为准。
06.5.6.11-011 Worker 收到退出指令时,在跑的请求如何收尾?
一句话结论
Worker 停止接收新请求后,等待当前协程/请求处理完成,释放连接与池资源后退出;未在收尾窗口结束的请求被中断,需在业务侧记录并设计补偿。
概念解释
Worker 退出时可能正持有在跑请求、数据库事务、Redis 连接与协程栈。收尾原则:不发起新业务,等待已有请求自然完成;事务在异常退出前回滚或提交到一致状态;连接池归还或关闭。长请求占用收尾窗口,超时后被强制中断。HTTP 请求中断后客户端收到连接关闭;异步任务依赖持久化状态补偿。
原理流程
- Master 通知 Worker 退出,Worker 不再取新请求。
- 在跑协程继续执行到返回,逐请求释放资源。
- 收尾窗口内完成的连接正常关闭;超时请求中断。
- Worker 退出,Master 回收进程。
代码或图示
Worker 收尾:
新请求停止进入 → 在跑请求继续跑完
→ 事务提交/回滚到一致状态 → 连接归还/关闭
→ 超时未结束:中断并记录 → 进程退出
常见误区
- 退出时把连接池里的空闲连接直接丢弃不检查:在借连接的事务状态需先处理。
- 假设被中断的请求客户端会自动重试:只有幂等接口适合自动重试,写请求需补偿记录。
追问
- 如何观测收尾是否及时?答:记录 Worker 从收到退出到退出完成的耗时,超时中断计数纳入告警。
- 大文件上传等长请求怎么办?答:发布窗口避开长任务;必要时网关先摘流量,再等待收尾。
06.5.6.11-012 信号中断正在执行的回调会发生什么?
一句话结论
信号是异步通知,回调执行不会被信号直接打断;信号回调在当前执行间隙被事件循环调度执行,正在运行的代码继续到让出点,具体打断粒度取决于运行时实现,需按版本核对,标注待确认。
概念解释
与内核线程信号处理不同,Swoole 进程内信号经事件循环分发:信号到达后登记,循环在合适时机执行回调。正在执行的纯 CPU 回调不会被信号立即中断;阻塞调用被 hook 后可能在挂起点感知事件。因此“发了停止信号进程马上停”并不成立,停止流程要等当前回调让出或结束。
原理流程
- 信号到达进程内核,运行时登记待处理信号。
- 当前回调继续执行到让出点或结束。
- 事件循环调度信号回调,执行退出/重载逻辑。
- 后续协程与请求按收尾流程停止或退出。
代码或图示
信号到达 → 内核递送到进程 → 运行时登记
当前回调执行中:不被强制打断,运行到让出点/结束
事件循环间隙 → 调度信号回调 → 进入退出/重载流程
常见误区
- 以为信号能立即中断当前代码:纯 CPU 长循环仍需执行完或产生让出点。
- 在信号回调中假设前序代码已全部完成:回调触发时机与版本调度实现相关。
追问
- 长循环里如何响应退出标志?答:循环片段间检查退出标志并主动让出;信号回调只负责置标志位。
- 阻塞系统调用被信号打断怎么办?答:被 hook 的调用按协程路径处理;未 hook 的阻塞调用行为需结合扩展文档核对。
06.5.6.11-013 容器环境下 PID 1 进程与信号转发有哪些陷阱?
一句话结论
容器入口进程默认是 PID 1,信号行为特殊;若用 shell 脚本启动服务,shell 会拦截信号而不转发给子进程,导致停止/重载信号到达不了 Swoole Master,表现为容器停止超时、强制被杀。
概念解释
Docker 容器中启动命令的第一个进程为 PID 1。常见问题:入口是 bash/sh 脚本,脚本 fork 出 Swoole Master 后前台等待,信号发给脚本进程而非子进程;shell 不默认转发信号。PID 1 还承担孤儿进程回收职责,缺少回收逻辑会产生僵尸进程。正确做法:前台直接运行服务进程,或使用具备信号转发与进程回收能力的入口方案。
原理流程
- 容器编排向容器 PID 发送停止信号。
- 若入口是 shell:信号被 shell 接收,子进程 Swoole Master 收不到。
- 编排器等待优雅停止超时,最终强制 SIGKILL。
- 服务未走优雅退出,连接与任务被中断。
代码或图示
陷阱链路:
docker stop 发送 SIGTERM → 入口 shell 接收
→ shell 不转发 → Swoole Master 未感知
→ 等待超时 → SIGKILL 强杀
正确形态:服务进程作为前台主进程,直接接收容器信号
常见误区
- 用
bash start.sh &后台启动再wait:信号转发仍受 shell 行为影响。 - 以为容器内
kill到的 PID 就是宿主机进程 PID:容器 PID 命名空间独立。
追问
- 容器内如何确认信号到达服务进程?答:在停止流程打印日志;先在测试容器发送信号,观察 Master 日志与退出耗时。
- 入口脚本必须保留怎么办?答:使用
exec替换进程,或选用显式转发信号、回收僵尸进程的进程管理方案;具体实现按所选基础镜像与工具核对。
06.5.6.11-014 Docker / Kubernetes 中 Swoole 服务如何正确接收停止信号?
一句话结论
服务进程应以前台方式作为容器主进程运行,让编排器的停止信号直达 Master;配合优雅停止超时配置、存活探针与流量摘除,保证发布与缩容时收尾完成。
概念解释
Kubernetes 终止流程:先通知端点摘除流量,等待 terminationGracePeriodSeconds,再发 SIGTERM,超时后 SIGKILL。容器内服务需直接监听 SIGTERM 并在宽限窗口内完成收尾。反向代理/网关先摘除实例后再结束进程,避免新流量进入即将退出的 Worker。探针配置要区分存活失败与正常发布收尾。
原理流程
- 镜像启动命令前台运行 Swoole Master,不经过拦截信号的 shell 包装。
- 编排器触发停止:先摘流量,再向容器主进程发 SIGTERM。
- Master 走优雅关闭流程,在宽限窗口内完成请求收尾。
- 窗口内退出则正常结束;超时被强杀,需评估中断影响。
代码或图示
K8s 终止顺序:
端点摘除 → SIGTERM → 优雅收尾(受 terminationGracePeriodSeconds 约束)
→ 超时未退出 → SIGKILL
镜像要点:前台主进程、信号直达 Master、收尾超时小于宽限窗口
常见误区
- 收尾超时大于容器宽限时间:进程还在收尾就被 SIGKILL。
- 探针在收尾期间持续失败:与发布流程冲突,需按状态区分主动退出与异常崩溃。
追问
- 信号转发用什么镜像方案?答:按基础镜像与进程管理工具选型;关键是主进程直接接收信号并回收子进程,具体方案不在本章节展开。
- 长连接在缩容时怎么处理?答:先摘流量、等待现有连接收尾,长连接设置服务端超时与客户端重连。
06.5.6.11-015 热重启失败或卡住的常见原因有哪些?
一句话结论
reload 卡住通常源于:旧 Worker 存在挂起协程/阻塞回调不退出、收尾超时配置过长、信号未送达 Master、进程处于异常状态;按信号链路、Worker 状态、在跑任务三段定位。
概念解释
排查顺序:先确认信号是否到达 Master(进程列表、启动方式、容器转发);再看旧 Worker 是否还在跑、卡在哪个回调;最后检查收尾超时与异常进程。常见卡点:未 hook 的阻塞调用占住 Worker、协程永久挂起等待外部事件、任务队列未清空、僵尸/异常 Worker 未被回收。reload 不生效还可能是变更在 Master 层或 opcode 缓存未刷新。
原理流程
- 核对 Master PID 与信号发送目标,确认信号送达。
- 列出 Worker 进程状态与启动时间,识别未退出的旧 Worker。
- 检查旧 Worker 在跑任务:阻塞回调、挂起协程、未清空任务队列。
- 核对收尾超时配置;必要时低峰期整体 restart 兜底。
代码或图示
reload 卡住排查:
信号链路:发送目标 PID / 容器转发 / Master 是否受理
Worker 状态:旧 Worker 是否存活 / 启动时间 / 进程状态
任务卡点:阻塞回调 / 永久挂起协程 / 任务队列残留
配置核对:收尾超时 / 重载范围 / opcode 缓存
常见误区
- 卡住后反复发 reload:多个重载请求叠加,Worker 状态更难判断。
- 直接 SIGKILL 旧 Worker:在跑事务与连接被中断,应先抓状态再决定兜底手段。
追问
- 如何看 Worker 卡在哪个回调?答:结合协程栈/进程堆栈、慢请求日志与任务队列状态;可用的堆栈接口以版本扩展能力为准,待确认。
- reload 后版本没变怎么办?答:区分 Master 层变更、opcache 缓存、代码包含位置;必要时整体 restart 验证。
06.5.6.11-016 信号处理与事件循环是什么关系?
一句话结论
信号监听挂在事件循环上:循环每轮检测待处理信号并调度回调;信号不脱离循环独立打断进程,因此信号回调的执行时机受当前回调阻塞与循环负载影响。
概念解释
事件循环统一管理 fd 事件、定时器与信号。信号到达后由运行时记录,循环在迭代中取出并执行对应回调。这意味着信号回调与网络回调、定时器回调共享执行权:前序回调阻塞时信号回调延后。理解这层关系可以解释“信号已发但进程反应慢”的现象。
原理流程
- 服务启动时,Master 在事件循环注册信号监听项。
- 信号到达,运行时把信号标记为待处理。
- 事件循环当前轮处理完手头事件后,分发信号回调。
- 回调执行退出/重载/自定义逻辑,后续流程按信号类型展开。
代码或图示
事件循环统一调度:
fd 读写事件 ─┐
定时器到期 ─┼─→ 循环每轮依次分发 → 回调执行
信号到达 ───┘
信号回调与其他回调共享执行权,前序阻塞会延后信号处理
常见误区
- 把信号当成独立中断线程:本进程内信号经循环分发,不存在独立信号线程打断当前代码的假设。
- 信号回调内阻塞等待:会延后其他事件与信号处理。
追问
- 信号监听是否占用 fd?答:实现方式取决于运行时(信号表/eventfd 一类),细节以扩展源码为准,待确认。
- 循环退出后信号回调还会执行吗?答:循环停止后事件不再分发;退出流程中收到的后续信号行为需按版本核对。
06.5.6.11-017 哪些情况必须整体 restart,不能只靠 reload?
一句话结论
变更发生在 Master 层、运行时配置、扩展编译参数、进程模型或监听端口时,reload 不覆盖,必须整体 restart;只影响 Worker 业务代码的变更才适合 reload。
概念解释
reload 重建的是 Worker/Task Worker,Master 与运行时环境保持。以下变更需 restart:php.ini 与扩展配置、Swoole 编译选项、Server 模式与 worker_num 等进程模型参数、监听端口与地址、Master 回调中加载的代码、共享内存结构定义。判断方法:梳理变更由哪个进程上下文读取与持有,Master 层持有即走 restart。
原理流程
- 列出本次变更涉及的配置项、代码文件与参数。
- 标注每项由 Master 还是 Worker 加载。
- 存在 Master/运行时层变更:整体 restart。
- 全部为 Worker 业务代码:按 reload 流程发布并验证版本探针。
代码或图示
需要 restart:
php.ini / 扩展配置 / Swoole 编译参数
Server 模式、worker_num、端口监听
Master 回调代码、共享内存表结构定义
可 reload:
Worker 上下文执行的业务代码(配合 opcode 缓存刷新)
常见误区
- 改进程模型参数后 reload 观察“没生效”:Master 未重建,参数不变。
- 表结构(Table 列定义)改后 reload:共享内存结构在 Master 层初始化,需 restart。
追问
- 如何区分变更在哪一层?答:阅读启动回调与配置读取代码;不确定时在测试环境分别 reload/restart 对比探针结果。
- restart 期间服务中断多久?答:取决于进程停止与启动速度;多实例部署时逐台重启避免整体中断。
06.5.6.11-018 reload 期间新请求如何被处理?
一句话结论
reload 期间监听端口保持打开,新请求由新拉起的 Worker 承接;旧 Worker 只处理存量连接,不再被分发新连接,避免新旧进程同时服务同一批请求造成状态混乱。
概念解释
Master 保留监听 fd 并在 Worker 替换过程中继续 accept。旧 Worker 停止领取新连接,专注收尾存量请求;新 Worker 就绪后接收新连接。替换节奏可以逐个进行,降低并发抖动。若新 Worker 启动失败,Master 的重试与告警行为需按版本核对。请求不会“排队等待 reload 完成”,而是在新旧 Worker 间按生命周期分配。
原理流程
- Master 收到 reload,保留监听 socket。
- 旧 Worker 停止接收新连接,处理存量请求。
- 新 Worker 逐个拉起,就绪后承接新连接。
- 旧 Worker 收尾退出,替换完成。
代码或图示
reload 期间请求流向:
新连接 → Master accept → 就绪的新 Worker
存量连接 → 留在旧 Worker 收尾
旧 Worker 不领取新连接;新 Worker 不承接旧连接
常见误区
- 以为 reload 瞬间服务不可用:监听保持,新请求由新 Worker 处理。
- 新旧 Worker 同时跑不同版本代码:发布窗口内短时间存在版本混合,探针与数据兼容需考虑。
追问
- 新旧版本数据格式不兼容怎么办?答:先做向后兼容发布,分批替换;避免新 Worker 读取旧版本写入的数据结构。
- 新 Worker 启动失败会怎样?答:Master 按策略重试或标记异常;具体行为与告警接口以版本文档为准,待确认。
06.5.6.11-019 平滑重启与 max_request 进程退出有什么区别?
一句话结论
max_request 是 Worker 处理一定数量请求后主动退出重建,用于释放常驻内存残留;平滑重启是外部触发的全量 Worker 替换,用于发布代码。两者都是 Worker 退出重建,但触发来源、范围与目的不同。
概念解释
max_request 由 Worker 在请求计数达到阈值后自行退出,Master 拉起新 Worker,目的是控制内存增长、规避泄漏累积。reload 由信号/接口触发,一次性协调全部 Worker 重建,目的是加载新代码。max_request 退出同样走收尾流程;两者叠加时,退出原因需在日志中区分。Task Worker 也有独立计数与退出策略。
原理流程
max_request:Worker 计数达到阈值 → 自身申请退出 → Master 回收并拉起新 Worker。- reload:外部信号 → Master 协调全部旧 Worker 退出 → 新 Worker 批量拉起。
- 两者退出都经过请求收尾与资源释放。
- 日志记录退出原因,区分防泄漏重建与发布替换。
代码或图示
max_request:计数阈值触发,单 Worker 轮换,目的是释放内存残留
reload:外部触发,批量替换,目的是加载新代码
共同点:Worker 进程退出重建,Master 保留;都走优雅收尾
常见误区
- 把
max_request当发布手段:它不保证加载新代码,只是进程轮换。 - 忽略两者叠加时的退出风暴:集中到达阈值可能造成多 Worker 同时退出,计数配置可加随机抖动。
追问
max_request阈值怎么定?答:结合内存增长曲线与重启成本;过小增加重建开销,过大泄漏累积,压测与线上观测回调。- 退出原因如何记录?答:在 Worker 退出回调/日志中标注触发来源;具体回调可用性以版本为准。
06.5.6.11-020 线上发布与信号处置的排查清单有哪些?
一句话结论
发布前核对变更层级(reload/restart)、信号链路与收尾超时;发布中观测新旧 Worker 替换、请求错误率与长连接掉线;异常时按信号送达、Worker 状态、在跑任务三段定位。
概念解释
清单覆盖发布前、发布中、发布后:配置与代码分级、容器信号直达、探针验证版本;替换过程中错误率、延迟、队列积压、连接数;回滚预案与兜底手段。信号相关问题最终都要回到“信号是否送达 Master、Worker 是否按流程收尾、超时是否配置合理”三个判断点。
原理流程
- 发布前:确认变更层级,选择 reload 或 restart;核对收尾超时小于容器宽限;准备版本探针。
- 发布中:分批替换,观测错误率、延迟、队列与连接指标。
- 异常排查:信号链路 → Worker 状态 → 在跑任务与阻塞点。
- 发布后:验证各 Worker 版本标识,观察内存与连接指标稳定。
代码或图示
发布排查清单:
[前] 变更层级 / 信号链路 / 收尾超时 / 探针版本
[中] 新旧 Worker 替换 / 错误率 / 延迟 / 队列积压 / 长连接掉线
[后] 版本一致性 / 内存趋势 / 连接池状态
兜底:低峰期整体 restart;强杀仅在确认无法优雅退出后使用
常见误区
- 发布后不验证版本:reload 未生效或 opcode 缓存遮蔽时,线上仍跑旧代码。
- 异常时直接批量强杀:扩大中断面,应先摘流量再逐个处置。
追问
- 哪些信号相关行为必须在目标版本复核?答:信号绑定、重载范围、收尾超时配置项、信号回调上下文;记录本机版本号后对照官方文档,不确定处标注待确认。
- 回滚怎么做?答:保留旧版本镜像/代码包,逐实例回退重启;回滚同样按优雅关闭流程,避免中断在跑请求。