异步任务结果不能用return返回，因执行在独立进程/协程中；应通过redis存储，推荐key格式"job:result:{$uuid}"并设过期时间；id须在构造函数生成并持久化；所有执行路径（含异常）均需写入结果。
任务执行结果为什么不能直接用 return 返回
因为异步任务在独立进程或协程中运行，handle() 的返回值无法穿透到发起方上下文。你调用 dispatch(new Job()) 后立刻返回，根本收不到那个 return 的值。强行同步等待（比如加 sleep() 或轮询内存变量）会破坏异步意义，还可能引发超时或资源泄漏。
用 Redis 存结果比数据库更合适的原因
Redis 天然支持过期时间、原子操作和高并发读写，适合临时存储任务状态与结果。数据库虽然持久，但写入延迟高、连接池易争抢，且任务结果通常只需保留几分钟到几小时。
- 结果 key 建议格式：
"job:result:{$uuid}"，避免命名冲突 - 写入时必须带
EX或setex()，否则结果永久滞留，缓存雪崩风险上升 - 不要用
SET+ 单独EXPIRE，非原子操作可能导致 key 永久存在 - 若需结构化数据（如含进度、错误堆栈），用
json_encode()后存字符串，别用哈希结构——增加序列化/反序列化负担
如何安全地生成和传递任务唯一 ID
很多失败源于 ID 重复或丢失。Laravel 默认用 uniqid('', true)，Hyperf 用 Str::uuid()，但自定义 Job 类若手动拼接 ID（如 $userId . time()），在毫秒级并发下极易碰撞。
- 务必在任务构造函数里生成 ID，并作为属性保存，而不是在
handle()中生成 - 不要依赖
__toString()或魔术方法隐式生成，调试时看不到真实值 - 提交任务后，立即将该 ID 和初始状态（如
"pending"）写入 Redis，防止消费者还没启动就丢任务 - 前端轮询时，把这个 ID 当作查询凭证传给 API，后端直接
$redis->get("job:result:{$id}")
消费者执行完不写结果的常见漏点
最容易被忽略的是异常路径：任务出错、超时、被 kill，或者 failed() 方法里没补写失败状态。用户轮询半天，发现 key 一直不存在，还以为系统卡了。
- 所有出口都要覆盖：正常完成、抛异常、超时中断、手动终止
- 推荐统一收口写结果逻辑，例如封装一个
saveJobResult(string $id, array $data)方法，在handle()结尾和failed()开头都调用它 - 写结果前加个
if (!$redis->exists("job:lock:{$id}"))判断，防重复写入（尤其重试场景） - 别把整个
$e->getTraceAsString()往里塞，截取前 500 字符即可，避免爆 Redis 单 value 限制（默认 512MB，但实际建议 ≤1MB）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
