Hyperf定时任务默认不支持直接传参，需通过闭包绑定参数或构造注入预设参数实现；前者适用于简单场景且变量固化，后者适合复用逻辑与多参数任务。
Hyperf 中定时任务默认不支持直接传参，因为定时任务是通过注解或配置注册到调度器的，运行时由框架自动触发，无法像普通方法调用那样动态传入参数。但可以通过几种合理方式将参数“带入”任务执行逻辑内部，核心思路是：把参数提前绑定、封装或通过上下文传递。
使用闭包绑定参数（推荐用于简单场景）
在注册定时任务时，用 call_user_func 或匿名函数捕获外部变量，实现参数“固化”：
- 在
Command或服务启动时动态注册任务，而非依赖静态注解 - 闭包内可访问当前作用域变量，如配置项、数据库 ID、业务标识等
- 注意闭包不能序列化，不可用于分布式部署下的持久化任务队列
示例：
$userId = 123;
$this->scheduler->addTask(new CallbackTask(function () use ($userId) {
echo "处理用户: {$userId}";
// 调用实际业务方法
app(UserService::class)->syncProfile($userId);
}, '0 * * * *'));
通过任务类属性 + 构造注入预设参数
定义一个可复用的定时任务类，在构造时接收参数并保存为属性，执行时直接使用：
- 需配合手动实例化 +
addTask注册，避开注解扫描限制 - 参数可来自配置、数据库查询结果或环境变量
- 适合需要复用逻辑但参数不同的多个任务（如按租户分片）
示例：
class SyncUserTask implements TaskInterface{
private int $userId;
public function __construct(int $userId)
{
$this->userId = $userId;
}
public function execute(): void
{
app(UserService::class)->syncProfile($this->userId);
}
// 注册
$this->scheduler->addTask(new SyncUserTask(456), '*/5 * * * *');
利用 Context 或协程本地存储（适用于运行时动态参数）
若参数在任务触发前才确定（如从消息队列读取），可在触发前写入 Context，任务内再读取：
- 借助
Co::getContext()或ApplicationContext::getContainer()->get(ContextInterface::class) - 注意 Context 是协程级的，确保写入和读取在同一线程/协程生命周期内
- 适合与消息驱动、事件回调联动的场景
示例：
// 触发前Context::set('task_params', ['order_id' => 789, 'channel' => 'wechat']);
// 任务类中
$params = Context::get('task_params', []);
if (!empty($params)) {
app(OrderService::class)->notify($params['order_id'], $params['channel']);
}
结合配置中心或数据库动态加载参数
当参数频繁变动或需多实例共享时，不在代码中硬编码，而是运行时查询：
- 任务执行时从配置中心（如 Nacos、Apollo）或数据库读取最新参数
- 加缓存（如协程内存缓存）避免每次重复查库
- 适合灰度开关、定时策略调整等运维友好型场景
示例：
public function execute(): void{
$config = $this->config->get('task.sync_interval', 300); // 单位秒
$targetIds = $this->redis->get('sync_targets') ?: [1,2,3];
foreach ($targetIds as $id) {
go(fn() => $this->doSync($id));
}
}
不复杂但容易忽略的是：Hyperf 的 @Cron 注解本质是编译期注册，所有信息必须静态可析出，所以任何“运行时参数”都得绕过注解，改用编程式注册或上下文桥接。选哪种方式，取决于参数来源稳定性、部署模式和复用粒度。
