常见问题及解决方案：一是 coupon_id 为空需校验优惠券存在性并确认字段名；二是积分扣减与发券须在同一事务中，避免数据不一致；三是过期券需定时任务补回积分；四是积分缓存需及时更新。
积分兑换优惠券时 coupon_id 为空或报错 Undefined index
常见原因是没在兑换逻辑里校验优惠券配置是否存在，或者数据库查出来的 coupon_id 字段名和实际表结构不一致。ThinkPHP 的 Db::name('coupon')->where(...)->find() 返回 null 后，直接取 $coupon['coupon_id'] 就会触发 PHP Notice。
- 务必先判断查询结果是否为空：
if (!$coupon) { throw new Exception('优惠券不存在或已下架'); } - 确认数据库字段名是
id还是coupon_id——ThinkPHP 默认主键是id，若你建表用的是coupon_id，需在模型中显式声明：protected $pk = 'coupon_id'; - 兑换接口的参数建议统一用
coupon_code或template_id入参，避免前端传原始 ID 引发越权风险
用户积分扣减与优惠券发放不在同一个事务里导致数据不一致
典型场景：扣了积分但优惠券没发成功，或发了券但积分没扣。ThinkPHP 的事务必须手动开启，Db::transaction() 包裹的代码块里任何一处抛异常都会回滚，但要注意不能在事务里调用外部 HTTP 请求（比如发短信、调用微信模板消息），否则可能卡住事务。
- 正确写法：
Db::transaction(function () use ($uid, $need_points) { // 1. 扣积分 Db::name('user')->where('id', $uid)->dec('points', $need_points); // 2. 生成优惠券记录 Db::name('user_coupon')->insert([ 'uid' => $uid, 'coupon_id' => $coupon['id'], 'status' => 1, 'create_time' => time() ]); }); - 不要把
Log::write()或event('CouponIssued', [...])放在事务内——日志写入失败不应影响业务一致性 - 如果用了模型（Model），记得在模型方法里也启用事务，别混用
Db和model->save()而不统一事务上下文
优惠券过期自动失效但积分未返还
优惠券过期是状态变更，不是删除操作，所以不能靠定时任务删记录来触发积分返还。ThinkPHP 没有内置“到期自动回调”，得自己补逻辑。
- 推荐方案：每日凌晨跑一个命令行任务（
php think coupon:expire），查出今天过期且未使用的user_coupon记录，批量更新状态为2（已过期），并用Db::name('user')->where(...)->inc('points', $points)补回积分 - 关键点：补积分时要加 where 条件限制只对
status = 0（未使用）的券生效，避免重复返还 - 别依赖前端或用户主动点击“过期券”来触发返还——没人点就永远不还
用户领券后积分实时显示不准
缓存没更新，或者前端读的是旧 session 数据。ThinkPHP 的 Cache::get('user_points_'.$uid) 如果没在积分变动后及时清除，就会一直返回旧值。
立即学习“PHP免费学习笔记（深入）”；
- 每次扣减/返还积分后，立刻执行：
Cache::delete('user_points_'.$uid) - 如果用了 Redis 缓存，注意 ThinkPHP 默认缓存 key 是带前缀的（如
think:cache:user_points_123），清除时要用完整 key 或统一前缀批量删 - 前端不要缓存用户积分字段——哪怕加了
Cache-Control: no-cache，也要在关键操作后主动 reload 用户信息接口
SELECT ... FOR UPDATE 或分布式锁。 
