Hyperf中统一批量修改优惠券状态与有效期，应采用事务包裹的批量SQL更新确保原子性，结合模型观察者处理副作用、分页校验防误操作，并通过缓存失效保障一致性。
Hyperf 框架中实现优惠券发放状态与有效期的统一批量修改，核心在于利用其高并发、协程友好、数据库操作高效的特点，结合事务控制、批量更新语句和合理模型设计，避免逐条更新带来的性能瓶颈和数据不一致风险。
使用事务 + 批量 SQL 更新（推荐）
直接执行原生 SQL 或 QueryBuilder 的批量更新，是最高效的方式，尤其适用于万级优惠券的统一批量操作。
- 通过 DB::update() 或 Query::table()->where(...)->update(...) 一次性修改符合条件的所有记录
- 包裹在 DB::transaction() 中，确保状态变更与有效期更新原子性
- 例如：将某批次优惠券全部设为“已发放”并统一设置过期时间为 7 天后
$now = date('Y-m-d H:i:s');
$expireAt = date('Y-m-d H:i:s', strtotime('+7 days'));
DB::transaction(function () use ($now, $expireAt) {
Coupon::query()
->where('batch_id', 1001)
->where('status', Coupon::STATUS_PENDING)
->update([
'status' => Coupon::STATUS_ISSUED,
'expired_at' => $expireAt,
'updated_at' => $now
]);
});
基于模型事件或观察者做副作用处理
若批量修改后还需触发通知、日志记录、缓存清理等逻辑，建议用模型观察者（Observer）解耦。
- 监听 updating 或自定义事件（如
CouponBatchUpdated） - 在观察者中处理发送短信、写操作日志、更新 Redis 缓存等非核心业务
- 避免在事务内做耗时 I/O 操作；可异步投递到消息队列（如 Kafka / Redis Queue）
支持条件化、分页式安全批量更新（防误操作）
生产环境不建议无限制全表更新。应加入校验与分片机制：
- 限定 WHERE 条件必须包含索引字段（如
batch_id、tenant_id、status），防止锁表或慢查询 - 对超大批量（如 >5000 条）启用分页更新，用
limit + offset或游标方式分批提交 - 提供预检接口：先
SELECT COUNT(*)校验影响行数，确认后再执行更新
配合缓存与状态同步（可选增强）
若优惠券状态被高频读取（如前端倒计时、核销页），需注意 DB 与缓存一致性：
- 批量更新后，可主动删除对应缓存键（如
coupon:batch:1001:status） - 或使用 Hyperf 的 Cacheable 注解 + 自定义 cache key 策略，让下次读取自动刷新
- 不建议在批量更新中同步写缓存，易拖慢主流程；优先走「失效」策略
