123 lines
5.1 KiB
Markdown
123 lines
5.1 KiB
Markdown
---
|
||
name: 直推积分奖励问题3排查
|
||
overview: 通过数据库排查发现：UID=55 和 UID=56 的 4 笔报单商品订单完全没有生成积分奖励记录，需要部署最新代码后使用补发命令修复。
|
||
todos:
|
||
- id: deploy-code
|
||
content: 将最新 queue 分支代码部署到生产服务器 47.94.76.64
|
||
status: pending
|
||
- id: patch-rewards
|
||
content: 在服务器执行 php think hjf:patch-rewards 补发缺失的积分奖励
|
||
status: pending
|
||
- id: verify-results
|
||
content: 查询 points_release_log 确认 4 笔订单的奖励记录已正确生成
|
||
status: pending
|
||
isProject: false
|
||
---
|
||
|
||
# 直推积分奖励问题3 排查结果与修复计划
|
||
|
||
## 数据库排查结果
|
||
|
||
### 推荐链与分销等级
|
||
|
||
|
||
| UID | 昵称 | spread_uid | agent_level | 等级名(grade) | direct_reward_points |
|
||
| --- | --- | ---------- | ----------- | ---------- | -------------------- |
|
||
|
||
|
||
- **UID=1** (初始账号): spread_uid=0, agent_level=3 (服务中心, grade=3), direct=1000, frozen_points=1983
|
||
- **UID=2** (潘186): spread_uid=1, agent_level=2 (云店, grade=2), direct=800, frozen_points=9296
|
||
- **UID=54** (金25): spread_uid=2, agent_level=1 (创客, grade=1), direct=500, frozen_points=0
|
||
- **UID=55** (金68): spread_uid=54, agent_level=0 (非分销员), frozen_points=0
|
||
- **UID=56** (wx363053): spread_uid=55, agent_level=0 (非分销员), frozen_points=0
|
||
|
||
推荐链确认: uid=1 -> uid=2 -> uid=54 -> uid=55 -> uid=56
|
||
|
||
### UID=55 和 UID=56 的已付款订单（全部 is_queue_goods=1）
|
||
|
||
- **#142** wx770632864445235200 | UID=55 | 范氏国香中式轻养生灸3条套装
|
||
- **#144** wx770679631480094720 | UID=55 | 城市休闲折叠单车6速+2条养生灸
|
||
- **#145** wx770680112881336320 | UID=55 | 紫兰国香粉嫩套装多部位可选
|
||
- **#146** wx770680790747971584 | UID=56 | 城市休闲折叠单车6速+2条养生灸
|
||
|
||
### 积分奖励记录
|
||
|
||
**这 4 笔订单在 `eb_points_release_log` 中完全没有任何 reward_direct / reward_umbrella 记录。**
|
||
|
||
对比同时期 UID=54 自己的订单 (#143 wx770633621278031872) 则正常生成了奖励（UID=1 获得 1000 直推奖励）。
|
||
|
||
### 预期应产生的奖励（以 UID=55 的一笔订单为例）
|
||
|
||
按当前代码 `propagateReward` 级差算法，UID=55 (非分销员) 购买后：
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
buyer["UID=55 买家 (agent_level=0, direct=0)"]
|
||
uid54["UID=54 创客 (depth=0, direct=500)"]
|
||
uid2["UID=2 云店 (depth=1, direct=800)"]
|
||
uid1["UID=1 服务中心 (depth=2, direct=1000)"]
|
||
|
||
buyer -->|"spread_uid=54"| uid54
|
||
uid54 -->|"actual=500-0=500"| uid54
|
||
uid54 -->|"nextLower=500"| uid2
|
||
uid2 -->|"actual=800-500=300"| uid2
|
||
uid2 -->|"nextLower=800"| uid1
|
||
uid1 -->|"actual=1000-800=200"| uid1
|
||
```
|
||
|
||
|
||
|
||
- UID=54 应获得 **500** 直推奖励(级差)
|
||
- UID=2 应获得 **300** 直推奖励(级差)
|
||
- UID=1 应获得 **200** 直推奖励(级差)
|
||
|
||
UID=56 的订单类似（UID=55 非分销员 depth=0 => directCascadeActive 变 false => 仅伞下奖励，如果开关开着的话）。
|
||
|
||
## 根因分析
|
||
|
||
1. **服务器代码未更新**：生产服务器（47.94.76.64）上运行的代码很可能不是最新版本。UID=54 的订单(#143)成功产生奖励，但 UID=55/56 的订单(#142/#144/#145/#146)完全没有记录，说明支付回调 [Pay.php](pro_v3.5.1/app/listener/order/Pay.php) 中的积分奖励逻辑未正确触发。
|
||
2. `**hjf_queue_pool_enable=0`**（公排关闭）：走的是同步分支（Pay.php L164-216），应直接调用 `reward()`。但实际未生成记录，说明该服务器的 Pay.php 可能还是旧版本。
|
||
3. **UID=54 订单的异常数据**：订单 #143 的 `order.spread_uid=1` 但 `user.spread_uid=2`（不一致），且 UID=1 拿到 1000 而非级差 200，进一步证实服务器运行的是更早的非级差版本。
|
||
|
||
## 修复方案
|
||
|
||
### 步骤 1：部署最新代码到生产服务器
|
||
|
||
确保以下文件已同步到 47.94.76.64：
|
||
|
||
- [app/listener/order/Pay.php](pro_v3.5.1/app/listener/order/Pay.php) — 支付回调中的积分奖励同步逻辑
|
||
- [app/services/hjf/PointsRewardServices.php](pro_v3.5.1/app/services/hjf/PointsRewardServices.php) — 级差+直推链校验
|
||
- [app/command/HjfPatchMissingRewards.php](pro_v3.5.1/app/command/HjfPatchMissingRewards.php) — 补发命令
|
||
|
||
### 步骤 2：使用补发命令修复缺失的积分奖励
|
||
|
||
代码部署后，在服务器上依次执行：
|
||
|
||
```bash
|
||
# 先 dry-run 确认哪些订单需要补发
|
||
php think hjf:patch-rewards --dry-run
|
||
|
||
# 也可针对单笔订单验证
|
||
php think hjf:patch-rewards --order-id=142 --dry-run
|
||
|
||
# 确认无误后执行实际补发
|
||
php think hjf:patch-rewards
|
||
```
|
||
|
||
该命令已内置幂等检查（跳过已有 reward 记录的订单），安全执行。
|
||
|
||
### 步骤 3：验证补发结果
|
||
|
||
补发后查询确认：
|
||
|
||
```sql
|
||
SELECT uid, points, type, mark, order_id
|
||
FROM eb_points_release_log
|
||
WHERE order_id IN (
|
||
'wx770632864445235200','wx770679631480094720',
|
||
'wx770680112881336320','wx770680790747971584'
|
||
)
|
||
ORDER BY order_id, uid;
|
||
```
|
||
|
||
预期：每笔 UID=55 的订单应产生 UID=54(500) + UID=2(300) + UID=1(200) 的记录；UID=56 的订单因 depth=0 非分销员，直推链中断，仅在伞下开关开启时产生伞下奖励。 |