06.5.5.10 Crontab 与 Process 进程管理
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf
06.5.5.10-001 Hyperf 的 Crontab 组件在常驻服务中扮演什么角色?
一句话结论
hyperf/crontab 在常驻进程内按 cron 表达式调度任务,任务随服务启动由框架托管触发,不需要依赖系统 crontab 拉起 PHP 进程;相比 FPM 时代的系统计划任务,任务在引导完成的容器内直接运行,可复用单例与连接池。
概念解释
系统 crontab 每次触发都重新引导框架,Crontab 组件在进程内维护定时器,到点回调任务方法。任务执行仍受协程模型约束:阻塞调用会影响所在调度单元,任务之间通过进程/协程隔离。
原理流程
- 启动期扫描定时任务注解,收集任务名、表达式与回调。
- 调度器按表达式计算下一次执行时间并登记定时器。
- 到点后在独立调度单元内执行任务回调。
- 执行结束记录结果,等待下一次触发。
代码或图示
// 组件包与注解命名空间以 vendor/hyperf/crontab 为准(待确认)
// composer require hyperf/crontab
use Hyperf\Crontab\Annotation\Crontab;
常见误区
- 以为 Crontab 任务每次触发都全新进程:常驻模型下容器与单例复用,静态状态与连接需要按常驻规则管理。
- 把系统 crontab 与框架 Crontab 混用管理同一任务:双重触发风险,需明确归属。
追问
- 调度器运行在哪个进程?答:通常随主服务进程内的调度机制运行,具体进程归属与隔离方式以组件实现为准(待确认:核对 vendor/hyperf/crontab 启动入口)。
- 服务重启后任务状态如何恢复?答:任务调度按进程内时间重新计算,未执行完的任务不会自动续跑;长任务需要自己做断点与补偿。
06.5.5.10-002 定时任务注解有哪些常用属性?
一句话结论
常用属性包括任务名 name、cron 表达式 rule、回调方法 callback、备注 memo,以及是否启用、所在进程分组等扩展属性;任务名用于日志、互斥锁与后台识别,不可重名。
概念解释
注解把元数据与任务类绑定:扫描期读取属性生成调度计划,运行期按任务名记录执行轨迹。回调属性指向类内方法,任务类从容器解析,可通过构造函数或属性注入获取依赖。
原理流程
- 在任务类或方法上标注 Crontab 注解,填写 name、rule、callback。
- 启动扫描期收集注解元数据,注册到调度器。
- 到点按回调方法名调用对应实例方法。
- 日志与互斥逻辑按任务名匹配。
代码或图示
// 属性名为示意;完整属性列表以组件注解类源码为准(待确认)
#[Crontab(
name: 'order.settlement',
rule: '0 2 * * *',
callback: 'settle',
memo: '每日凌晨结算订单'
)]
class SettlementTask
{
public function settle(): void
{
// 任务逻辑
}
}
常见误区
- 多个任务使用相同任务名:日志、锁与后台管理按名匹配,重名会互相干扰。
- 回调方法名拼写错误:启动期不一定报错,到点才反射调用失败。
追问
- 表达式在哪里可以单独配置?答:部分版本支持把 rule 放在配置文件或配置中心,注解保留任务定义;配置覆盖方式以组件文档为准(待确认)。
- 任务类需要实现什么接口?答:通常有约定的任务基类或接口约束;具体签名以源码为准,不要凭记忆 implements。
06.5.5.10-003 cron 表达式的字段含义与 Hyperf 支持范围是什么?
一句话结论
标准五位表达式依次为分、时、日、月、周;组件基于 cron 解析库计算触发时间,特殊字符 *、/、,、- 与 ? 的支持范围以所用解析库为准,非标准秒级或年份字段需先确认。
概念解释
表达式只定义触发时刻,不保证任务执行耗时边界:任务跑一小时,下一次触发仍按表达式到达。选型时要区分“每分钟”“每小时第几分”“工作日”等语义,避免日与周同时约束造成歧义。
原理流程
- 按分、时、日、月、周五位书写表达式。
- 解析库把表达式换算为下一次触发时间点。
- 到达时间点调度器触发任务。
- 任务执行期间调度器继续按原计划登记后续触发。
代码或图示
# 分 时 日 月 周
0 2 * * * # 每日 02:00
*/5 * * * * # 每 5 分钟
0 9 * * 1-5 # 工作日 09:00
常见误区
- 把秒位写进五位表达式:表达式被解析为错误字段,触发时间异常。
- 以为到点任务一定马上执行:调度单元繁忙时存在延迟,长任务会挤压后续触发。
追问
- 表达式支持
@daily这类预定义写法吗?答:取决于解析库;不确认时先用标准五位写法。 - 时区按什么计算?答:默认跟随进程时区配置;跨时区部署需统一进程时区,避免任务在错误时间触发。
06.5.5.10-004 任务类如何编写?回调方法的签名与返回值怎么约定?
一句话结论
任务类由容器管理,回调方法接收组件约定的上下文参数(可能包含任务实例),返回值通常不强制;任务内部应自行捕获异常、记录日志并处理结果,避免异常直接打断调度单元。
概念解释
与控制器不同,定时任务没有 HTTP 请求对象,入参来自任务定义而非用户输入。依赖通过容器注入;任务内读取配置、调用服务层,不要在回调里写重型初始化。返回值约定以组件源码为准,不确定时标注待确认。
原理流程
- 定义任务类,通过构造函数或注入注解声明依赖。
- 实现回调方法,方法内编排业务步骤。
- 捕获可预期异常并记录,不可预期异常交组件兜底。
- 任务结束后释放局部大对象,不把结果挂到单例属性。
代码或图示
class SettlementTask
{
public function __construct(private OrderService $orderService)
{
}
public function settle(): void
{
try {
$this->orderService->settleBatch();
} catch (\Throwable $e) {
// 记录任务失败日志与告警上下文
logger()->error('settlement failed', ['exception' => $e]);
}
}
}
常见误区
- 回调方法里依赖请求对象或上下文:定时任务没有请求协程上下文,取不到请求数据。
- 把批次结果存在任务类属性上:任务类为单例,属性会被下一次触发覆盖。
追问
- 任务能拿到当前任务定义吗?答:部分实现会把 Crontab 实例作为回调参数传入;参数类型与可用性以源码为准(待确认)。
- 任务输出写到哪里?答:写日志通道或结果表;不要依赖控制台 stdout 作为业务记录。
06.5.5.10-005 多实例部署时如何防止同一任务重复执行?
一句话结论
多台实例都会加载同一份任务定义,需要靠分布式互斥保证同一时刻只有一个实例执行:常见手段是 Redis 锁、数据库选主或注册中心领导选举;互斥键按任务名构造,并设置过期时间兜底。
概念解释
框架 Crontab 不天然感知集群拓扑,每个实例独立调度。没有互斥时,多实例同时跑结算、发券等任务会产生重复副作用。互斥逻辑要在任务入口抢锁,抢不到就跳过;锁过期与任务时长需要评估,避免锁未释放任务已完成或任务超长被锁超时误释放。
原理流程
- 任务入口按任务名构造互斥键。
- 实例尝试获取带过期时间的分布式锁。
- 获锁成功执行任务,结束释放锁;未获锁直接跳过本轮。
- 任务异常退出时锁靠过期时间兜底,避免死锁。
代码或图示
public function settle(): void
{
$lockKey = 'crontab:lock:order.settlement';
if (! $this->redis->set($lockKey, 1, 'NX', 'EX', 600)) {
return;
}
try {
$this->orderService->settleBatch();
} finally {
$this->redis->del($lockKey);
}
}
常见误区
- 锁不设过期时间:实例在任务中途崩溃,锁永远不释放,后续任务全部跳过。
- 任务执行时间超过锁过期时间:另一实例获锁并发执行,互斥失效;超时时间要大于任务最坏耗时。
追问
- 框架组件是否内置集群互斥?答:部分版本提供任务互斥配置或锁扩展;是否内置、默认行为以组件源码为准(待确认)。
- 抢锁失败如何观测?答:记录跳过日志与计数,确认是正常互斥还是锁泄漏导致全部跳过。
06.5.5.10-006 上一次任务还没执行完,下一次触发怎么办?
一句话结论
需要明确并发策略:串行(跳过本轮等下次)、排队等待,还是允许并发;框架默认行为以组件实现为准,业务上应避免长任务叠加并发,通常选择“未执行完则跳过本轮”并记录告警。
概念解释
定时任务的并发控制与队列消费不同:调度器到点触发,是否重叠取决于组件策略。任务是结算、清榜等强一致性操作时,重叠执行风险很高;任务自身要能识别上一批是否未完成,必要时用上一轮运行标记判断。
原理流程
- 任务开始前检查运行标记或上一轮完成状态。
- 上一轮仍在运行:按策略跳过、排队或并发执行。
- 任务结束清除运行标记,记录完成时间。
- 长期出现重叠说明任务耗时超过触发周期,需要拆分或提高周期。
代码或图示
public function settle(): void
{
$runningKey = 'crontab:running:order.settlement';
if ($this->redis->exists($runningKey)) {
logger()->warning('previous settlement still running, skip');
return;
}
$this->redis->set($runningKey, 1, 'EX', 3600);
// ... 执行业务
$this->redis->del($runningKey);
}
常见误区
- 默认假设任务每次都能在周期内跑完:数据量增长后任务超时,重叠执行无人发现。
- 跳过本轮不记录:排障时分不清是正常跳过还是任务从未启动。
追问
- 任务排队等待合理吗?答:适合短任务;长任务排队会越积越多,应拆分批次或改为独立常驻进程。
- 怎么监控任务是否重叠?答:记录每次开始/结束时间与运行标记,叠加任务耗时曲线,重叠与超时一目了然。
06.5.5.10-007 任务执行超时如何识别与中断?
一句话结论
超时识别靠开始时间戳与耗时阈值对比;PHP 任务没有强制抢占式中断,业务需要在批次循环内检查时间预算,到点主动停止本批并保留断点,剩余数据下一轮继续。
概念解释
协程/进程只能响应协作式中断:外部设置的超时信号需要任务代码配合检查。长批次任务按小批次循环处理,每批前判断剩余时间;超出预算就收尾退出,把进度写入断点表,避免一次性处理过大数据集。
原理流程
- 任务记录开始时间与允许耗时上限。
- 按小批次拉取数据处理,每批前检查剩余预算。
- 预算不足:保存批次断点,退出本轮。
- 下一轮从断点继续,失败批次进入补偿清单。
代码或图示
public function settle(): void
{
$deadline = time() + 240;
foreach ($this->orderRepository->yieldPending() as $batch) {
if (time() >= $deadline) {
$this->checkpoint->save($batch->cursor);
break;
}
$this->orderService->settleBatch($batch);
}
}
常见误区
- 指望框架到点强制杀掉任务:PHP 协作式执行下,阻塞循环不会被自动中断。
- 一次性把全量数据查进内存再处理:耗时与内存都不可控,超时无法分批退出。
追问
- 超时后任务状态怎么记录?答:标记为“未完成/断点续跑”,与“执行失败”区分;断点持久化到存储而非内存。
- 外部信号能终止任务吗?答:进程级信号由扩展与进程管理处理;任务代码是否响应信号中断需结合实现确认(待核对组件与扩展能力)。
06.5.5.10-008 任务失败如何处理与补偿?
一句话结论
失败要分级:可重试的暂时性失败按次数重试,不可恢复的坏数据进入异常清单;任务结果落表记录成功、失败与原因,配合对账任务兜底,不能只靠日志事后翻找。
概念解释
定时任务没有用户在线等待,失败结果必须可追溯、可重放。每批次记录处理条数、成功条数、失败明细;补偿任务按失败清单重跑,避免全量重扫。告警在连续失败或积压超过阈值时触发。
原理流程
- 任务执行中捕获单条/单批异常,分类记录失败原因。
- 暂时性失败进入重试队列或下次任务重试。
- 不可恢复失败写入异常表,附带报文与堆栈。
- 对账/补偿任务定期扫描异常表,修复后重跑并标记结果。
代码或图示
try {
$this->orderService->settleBatch($batch);
} catch (\Throwable $e) {
$this->failureRepository->save([
'task' => 'order.settlement',
'batch' => $batch->cursor,
'reason' => $e->getMessage(),
]);
throw $e;
}
常见误区
- 失败只打一行日志:没有结构化记录,补偿时无法定位坏数据范围。
- 全量重跑补偿:重复处理已成功数据,副作用不幂等会出问题。
追问
- 重试几次合适?答:按下游故障特征定,通常 2-3 次;超过次数转人工/异常表,不在任务内无限重试。
- 任务结果如何对接监控?答:输出成功/失败/耗时指标与计数,接入现有可观测体系;具体指标组件以项目实际为准。
06.5.5.10-009 自定义 Process 是什么?与 Worker、Task Worker 有什么区别?
一句话结论
自定义 Process 是框架提供的常驻独立进程,用于跑长驻循环、消费者、后台守护任务;Worker 进程服务网络请求,Task Worker 处理异步任务,三者进程角色不同,资源与故障互不抢占。
概念解释
Process 由 hyperf/process 组件托管注册,进程内一般跑 while 循环或订阅消费,生命周期跟随服务启动与停止。把长驻任务塞进 Worker 会阻塞请求处理;放进独立 Process 可隔离内存、CPU 与故障域。
原理流程
- 定义 Process 类继承抽象进程基类,注册到进程管理器。
- 服务启动时组件按配置拉起对应数量的进程。
- 进程内执行
handle()主循环,处理常驻任务。 - 服务停止时执行停止回调,清理资源后退出。
代码或图示
Worker 进程 → 处理 HTTP / RPC / WebSocket 请求
Task Worker → 承接投递的异步任务(扩展能力,引用不展开)
自定义 Process → 常驻守护循环、队列消费者、后台轮询任务
常见误区
- 把阻塞长循环写进控制器或 Worker 回调:请求并发被拖住,应迁移到独立 Process。
- 多个不同职责的守护逻辑塞进同一 Process:一个异常拖垮全部职责,应拆分进程。
追问
- Process 之间共享内存吗?答:进程内存相互隔离,共享状态走 Redis、数据库或进程间通信机制。
- 进程数在哪里配置?答:注解或进程配置中声明 nums;具体字段以组件源码为准(待确认)。
06.5.5.10-010 Process 类如何注册?注解与基类分别做什么?
一句话结论
Process 类继承 AbstractProcess(基类名称以源码为准),通过 #[Process] 注解声明进程名、数量等元数据;启动扫描期收集注册,基类提供生命周期钩子与容器访问能力。
概念解释
注解负责“注册元数据”,基类负责“生命周期约定”:子类实现主循环方法,可选重写启动前、停止后回调。进程名用于进程管理日志与区分多个实例,多实例时按进程编号区分职责。
原理流程
- 新建类继承进程基类,标注 Process 注解并填写 name、nums。
- 实现主循环方法,内部编排常驻任务逻辑。
- 启动期组件扫描注册,按数量拉起进程。
- 进程退出或被拉起时由管理器按策略处理。
代码或图示
// 基类与注解属性以 vendor/hyperf/process 源码为准(待确认)
namespace App\Process;
use Hyperf\Process\AbstractProcess;
use Hyperf\Process\Annotation\Process;
#[Process(name: 'report-consumer', nums: 1)]
class ReportConsumerProcess extends AbstractProcess
{
public function handle(): void
{
// 常驻循环逻辑
}
}
常见误区
- 进程类未被扫描路径覆盖:注解不生效,进程根本不会拉起。
- 在构造函数里跑循环:构造函数只做依赖装配,主循环应在基类约定的回调方法内。
追问
- 进程类从容器取依赖吗?答:基类通常提供容器访问方式;注入构造函数的依赖在进程启动时解析,注意启动阶段组件就绪顺序。
- 进程名重复会怎样?答:进程管理与日志按名区分,重名会导致定位混乱。
06.5.5.10-011 Process 有哪些生命周期回调?
一句话结论
典型生命周期包括进程启动前初始化、主循环执行、进程停止时清理;方法命名与调用时机以组件基类源码为准,不确定的钩子标注待确认并核对 vendor 实现。
概念解释
常驻进程需要在启动时初始化连接、加载缓存,在停止时释放资源、保存断点。把这些动作放对钩子:启动钩子做一次性准备,主循环做周期任务,停止钩子做兜底清理,避免依赖析构函数收尾。
原理流程
- 进程创建后执行启动回调:初始化客户端、预热数据。
- 进入主循环回调,持续处理任务。
- 收到停止信号后执行停止回调:释放连接、落盘断点。
- 进程退出,管理器按策略决定是否重新拉起。
代码或图示
class ReportConsumerProcess extends AbstractProcess
{
public function beforeStart(): void
{
// 启动前初始化:预热配置、建立首个连接
}
public function handle(): void
{
// 主循环
}
public function beforeStop(): void
{
// 停止前清理:保存断点、释放资源
}
}
常见误区
- 在析构函数里做关键清理:进程被强杀时析构不保证执行,关键状态应在运行中及时落盘。
- 启动回调里做阻塞长初始化:进程启动变慢,管理器可能判定异常。
追问
- 回调能抛异常吗?答:启动回调失败会影响进程拉起;停止回调应兜底捕获,避免清理阶段异常掩盖主问题。
- 进程重启后状态如何恢复?答:依赖持久化断点与外部存储,进程内存状态不保留。
06.5.5.10-012 Process 进程数量 nums 与协程开关如何设置?
一句话结论
nums 决定拉起几个相同进程;协程开关决定进程内任务是否运行在协程环境中。CPU 密集型任务不宜多开进程争抢核数,IO 密集型任务可结合协程提高单进程利用率,配置按压测结果调整。
概念解释
进程是资源隔离单位,协程是进程内并发单位。多进程适合隔离故障与利用多核;协程适合单进程内挂起 IO 等待。进程内若使用协程客户端,需开启协程环境;纯同步阻塞逻辑在协程开关下仍会阻塞调度。
原理流程
- 按任务类型判断:CPU 密集少进程,IO 密集可多进程加协程。
- 配置 nums 与协程开关属性。
- 观测各进程 CPU、内存与任务处理速率。
- 下游受限时优先收缩并发,而非盲目加进程。
代码或图示
#[Process(name: 'report-consumer', nums: 2, enableCoroutine: true)]
class ReportConsumerProcess extends AbstractProcess
{
// enableCoroutine 属性名以组件源码为准(待确认)
}
常见误区
- nums 开到与 CPU 核数一致跑 CPU 密集任务:上下文切换开销反而增大。
- 协程开关开启但内部用同步阻塞函数:协程并发名存实亡。
追问
- 多进程如何分工?答:按进程编号取模、按队列分区或按业务标签划分,避免各进程重复抢同一批任务。
- 进程内存怎么估算?答:单进程常驻对象、连接与协程栈内存乘以 nums,需在容器内存配额内留余量。
06.5.5.10-013 常驻进程主循环如何写?如何响应退出信号?
一句话结论
主循环按“检查退出标记 → 取任务 → 处理 → 短暂挂起”组织,避免空转 CPU;退出由组件信号回调配合循环内标记完成,循环体要能在停止时尽快退出并保存现场。
概念解释
没有任务可处理时不能忙轮询,应短暂挂起让出调度;循环每次迭代都检查停止标记,收到停止信号后完成当前批次再退出。连接与订阅在循环外建立,循环内只做取数与处理。
原理流程
- 启动回调建立连接、初始化依赖。
- 进入循环:检查退出标记,拉取或等待任务。
- 处理任务并记录结果;无任务时挂起短暂等待。
- 收到停止信号:置标记,当前批次结束后退出循环,执行清理回调。
代码或图示
public function handle(): void
{
while (! $this->isStopping()) {
$message = $this->consumer->pull();
if ($message === null) {
\Swoole\Coroutine::sleep(1);
continue;
}
$this->processMessage($message);
}
}
常见误区
- 循环里不加等待空转:CPU 被打满,机器负载异常。
- 循环内永不检查退出标记:进程停止时无法优雅退出,只能被强杀。
追问
isStopping之类方法是否存在?答:基类提供的停止判断方法名以源码为准(待确认);可结合组件信号回调自行维护标记。- 循环内 panic 怎么办?答:捕获异常避免单次错误终止整个循环;持续失败时主动退出让管理器重启,避免静默空转。
06.5.5.10-014 进程间有哪些通信方式?各自适用什么场景?
一句话结论
进程间状态共享优先走 Redis、数据库等外部存储;框架/扩展提供的管道、共享内存等 IPC 属于底层能力,框架层只引用不展开;选型按数据量、实时性与持久性要求决定。
概念解释
进程内存隔离,不能靠静态变量交换数据。轻量实时信号可走扩展 IPC;业务数据与互斥状态走外部存储更可靠、可观测。跨进程广播配置或事件时,借助消息队列或配置中心比本地 IPC 更易扩展到多机。
原理流程
- 判断通信内容:临时信号、任务分配还是业务数据。
- 跨机场景只能用 Redis/MQ/数据库;单机场景可评估本地 IPC。
- 约定数据格式与过期策略,避免通道堆积。
- 通信失败有降级与重试策略。
代码或图示
跨进程状态/锁/计数 → Redis
跨进程业务消息 → 消息队列
持久化结果与断点 → 数据库
单机轻量信号 → 扩展 IPC(引用,不在本章节展开)
常见误区
- 用文件做跨进程协调:并发读写与锁语义容易出问题,优先用 Redis 等成熟方案。
- 把大对象放进共享内存:生命周期与淘汰策略复杂,排查困难。
追问
- 进程崩溃后 IPC 数据还在吗?答:本地 IPC 与共享内存随进程消失;需要保留的状态必须落外部存储。
- 框架提供进程间事件广播吗?答:进程内事件分发不跨进程;跨进程通知需借助外部组件,具体能力以项目安装组件为准。
06.5.5.10-015 进程崩溃后如何被重启?重启策略边界在哪里?
一句话结论
进程的拉起与监控由扩展进程管理器与框架 Process 组件共同承担;框架层负责注册与回调,崩溃检测、重新 fork 等底层机制由扩展提供,不在本章节展开。业务侧要保证重启后可从持久化状态恢复。
概念解释
进程异常退出后,管理器按策略重新拉起新进程,新进程内存为空,不能依赖旧进程内存中的未保存状态。频繁崩溃说明代码或依赖有问题,应看崩溃日志与退出原因,而不是无限拉起掩盖问题。
原理流程
- 进程因异常、信号或 OOM 退出。
- 管理器检测到进程退出,按策略重新拉起。
- 新进程执行启动回调,从外部存储恢复断点与配置。
- 观测重启次数:短时间反复重启触发告警,进入故障排查。
代码或图示
进程退出
├─ 异常堆栈 → 修复代码/依赖
├─ OOM → 排查内存增长与批次大小
└─ 信号停止 → 区分优雅停止与被强杀
重启后从 Redis/DB 恢复断点,不依赖旧内存状态
常见误区
- 假设重启后任务接着上次内存位置跑:未持久化的进度会丢失。
- 崩溃重启不告警:问题被自动拉起掩盖,日志中反复出现启动记录。
追问
- 重启间隔会被限制吗?答:防止崩溃循环的重启策略由扩展/进程管理器实现;具体参数以部署配置为准(待确认)。
- 如何区分正常滚动重启与崩溃重启?答:对照发布时间线与停止信号类型,结合进程退出码与日志判断。
06.5.5.10-016 Process 常驻进程与 Crontab 定时任务如何选型?
一句话结论
需要持续监听、循环消费或长驻守护的职责用 Process;按固定周期触发、批处理结算用 Crontab;两者可组合:Process 常驻消费,Crontab 定时补扫与对账。
概念解释
选型核心是触发模型:事件驱动(消息到达、定时拉取)适合常驻进程;时间驱动(每日、每小时批次)适合定时任务。把周期批处理写成死循环轮询会浪费资源且难以管理;把消息消费塞进定时任务会引入延迟与轮询开销。
原理流程
- 梳理职责:是否需要持续在线、是否按时间点触发。
- 消息/事件驱动 → 独立 Process 或组件托管消费者。
- 周期批次/对账/报表 → Crontab。
- 混合场景:常驻链路 + 定时补偿任务配合。
代码或图示
队列消费、后台守护、长连接监听 → Process 常驻进程
每日结算、定时报表、周期对账 → Crontab 定时任务
消费链路 + 漏消息补扫 → Process + Crontab 组合
常见误区
- 用 Crontab 每分钟轮询模拟常驻服务:延迟高、空转多,周期边界难管理。
- 把定时批处理放进 Process while 循环自己算时间:重复造调度器,表达式与互斥能力缺失。
追问
- 一个进程能否同时跑多个守护职责?答:可以但不建议;职责耦合后故障域扩大,独立进程更易扩缩容与排障。
- 定时任务需要长驻状态吗?答:周期任务状态尽量外部化;需要内存累积状态的职责更适合常驻进程。
06.5.5.10-017 进程内依赖初始化与连接获取时机怎么安排?
一句话结论
进程启动阶段一次性初始化不可变配置与长生命周期客户端;循环内按需从连接池借还连接,不在进程启动时持有一次性 DB 连接,避免连接失效与协程并发借用问题。
概念解释
Worker 与 Process 都常驻:构造函数/启动回调拿到的是单例与客户端工厂;具体 DB、Redis 连接每次使用时从池获取。启动阶段组件可能尚未全部就绪,IO 初始化要放在框架就绪之后的钩子中。
原理流程
- 启动回调读取配置、解析不可变依赖。
- 进入循环前建立可复用的长驻客户端(如订阅连接)。
- 每次任务内从连接池获取短连接,用完归还。
- 连接异常时由池或客户端重连,业务不自行缓存失效连接。
代码或图示
public function handle(): void
{
while (! $this->isStopping()) {
// 循环内按需从仓库/连接池取连接,不缓存单次连接对象
$orders = $this->orderRepository->fetchPending();
$this->reportService->dispatch($orders);
\Swoole\Coroutine::sleep(2);
}
}
常见误区
- 启动时
new一个 DB 连接全程复用:连接被池外持有,断线后无法自愈。 - 在进程构造函数里做网络请求:组件就绪顺序不保证,可能拿到未初始化的依赖。
追问
- 进程内单例与 Worker 内单例是同一份吗?答:不同进程内存独立,单例不跨进程共享;同进程内复用容器单例。
- 连接预热要不要在启动时做?答:可预热连接池减少首批任务延迟;预热失败要能重试并告警,不阻塞进程退出。
06.5.5.10-018 定时任务与常驻进程在协程环境下有哪些阻塞注意事项?
一句话结论
无论是定时回调还是进程循环,都应使用协程化客户端;同步阻塞扩展、文件锁、sleep 等待会卡住所在调度单元,降低并发并影响其他任务,长耗时计算应隔离到独立进程。
概念解释
常驻模型下阻塞代价被放大:一次阻塞不只是当前请求等待,还占用 Worker 或进程内调度资源。任务内调用第三方 HTTP、DB、Redis 都要走协程客户端;CPU 密集片段应控制时长,避免长时间占住协程。
原理流程
- 识别任务内所有 IO 调用来源。
- 替换为框架协程客户端或连接池组件。
- 阻塞等待改为协程挂起等待,让出调度。
- 监控任务耗时与阻塞迹象,必要时拆分进程。
代码或图示
// 不使用同步阻塞函数等待退避
// 错误:usleep / sleep 卡住调度单元
// 正确:协程等待组件提供的挂起能力,或下一轮循环再处理
\Swoole\Coroutine::sleep(1);
常见误区
- 定时任务量小就不考虑协程安全:单次阻塞同样影响同进程其他协程。
- 在循环里调用未协程化的老扩展:并发退化难以从日志直接看出,需结合耗时曲线定位。
追问
- 怎么判断调用是否阻塞?答:确认底层为协程客户端或已 hook 阻塞函数;老同步扩展需替换,不确定时对照扩展文档(待确认)。
- 任务内发起并行调用怎么做?答:使用框架并发工具在协程内并行等待;不要为了并行再起同步线程。
06.5.5.10-019 多进程部署下如何按编号划分职责?
一句话结论
多进程实例可通过进程编号做取模分区、队列分区或标签订阅,让各进程承担不重叠的子集;编号由组件在拉起时分配,具体获取方式以源码为准,不能假设编号固定不变。
概念解释
无分区时多进程竞争同一批任务,依赖互斥保证不重复;分区后各进程处理固定子集,吞吐更高、锁竞争更少。分区方案要支持扩容:取模方案在进程数变化时会重排,队列分区更适合稳定规模。
原理流程
- 确定分区维度:按主键取模、按队列名、按业务标签。
- 进程启动时获取自身编号与总进程数。
- 只拉取属于本进程分区的数据或订阅对应队列。
- 扩容时评估分区重排影响,必要时借助队列转移。
代码或图示
// 编号获取方式以基类属性为准(待确认)
$mod = $this->processId % $this->processCount;
foreach ($this->orderRepository->fetchByMod($mod) as $order) {
$this->handle($order);
}
常见误区
- 假设进程编号永远稳定:重启后编号可能变化,分区状态不要只依赖编号。
- 分区键倾斜:某些分区数据量远大于其他,个别进程成为瓶颈。
追问
- 跨多台机器怎么分区?答:单机进程编号只能区分本机实例;跨机分区要按业务键一致性哈希或独立队列分配,外部存储记录分配关系。
- 分区漏数据怎么排查?答:核对各分区数据量总和与全量,检查分区键路由是否一致。
06.5.5.10-020 线上定时任务与常驻进程的排查清单是什么?
一句话结论
按“进程是否拉起 → 调度/循环是否执行 → 任务耗时与结果 → 依赖与资源 → 数据补偿”顺序排查:先确认进程存活与注册生效,再看执行记录与日志,接着查下游与资源水位,最后用补偿表兜底。
概念解释
常见问题分三类:注册未生效(注解/扫描路径)、进程崩溃或阻塞、任务逻辑失败。排查时保留任务名、时间点、进程编号与错误堆栈;组件默认行为不确定时先核对 vendor 源码与官方文档,不凭记忆改配置。
原理流程
- 确认进程/任务已注册:扫描路径、注解生效、启动日志有拉起记录。
- 查看执行记录:开始/结束时间、跳过原因、失败堆栈。
- 检查下游依赖与资源:DB/Redis/接口耗时、CPU、内存、连接数。
- 核对数据缺口:补偿表与对账结果,必要时手动重放。
代码或图示
1. 进程/任务注册是否生效
2. 启动日志:拉起数量、异常退出记录
3. 执行日志:耗时、跳过、失败原因
4. 下游与资源水位
5. 数据缺口与补偿重放
常见误区
- 只看主服务日志找不到进程日志:独立进程的日志可能分通道或分文件,需先确认输出位置。
- 任务失败直接重跑全量:未做幂等与断点,容易产生重复副作用。
追问
- 如何确认任务根本没被调度?答:对比调度注册记录、触发时间点与任务执行日志;检查表达式、时区与进程分组配置。
- 组件行为与预期不符怎么办?答:标注「待确认」,核对
vendor/hyperf/crontab、vendor/hyperf/process对应实现与当前版本文档,验证后再调整生产配置。