soul-yongping/开发文档/8、部署/可提现金额计算修复.md

可提现金额计算修复

问题总结

发现的问题

当前逻辑（错误）：

可提现金额 = 累计佣金 - 待审核金额

问题场景：

1. 用户累计佣金 ¥100，申请提现 ¥50
2. 此时：可提现 = 100 - 50 = ¥50 ✅ 正确
3. 审核通过后，提现记录状态改为 completed
4. 此时：可提现 = 100 - 0 = ¥100 ❌ 错误！

根本原因：审核通过后，pendingWithdrawAmount 归零，但没有减去"已提现金额"，导致可提现金额"回血"。

正确方案

计算公式

可提现金额 = 累计佣金 - 已提现金额 - 待审核金额

字段说明

字段	说明	来源	变化规律
totalCommission	累计佣金总额	SUM(orders.amount) × distributorShare	有新订单就增加，只增不减
withdrawnEarnings	已提现金额	users.withdrawn_earnings	审核通过时累加
pendingWithdrawAmount	待审核金额	SUM(withdrawals.amount WHERE status='pending')	申请时增加，审核后归零
availableEarnings	可提现金额	前端计算	动态变化

修复内容

1. 前端计算逻辑修正

文件：miniprogram/pages/referral/referral.js

修改前：

// ❌ 错误：只减去待审核，没减去已提现
const totalCommissionNum = realData?.totalCommission || 0
const pendingWithdrawNum = realData?.pendingWithdrawAmount || 0
const availableEarningsNum = totalCommissionNum - pendingWithdrawNum

修改后：

// ✅ 正确：三元素完整计算
const totalCommissionNum = realData?.totalCommission || 0
const withdrawnNum = realData?.withdrawnEarnings || 0
const pendingWithdrawNum = realData?.pendingWithdrawAmount || 0
const availableEarningsNum = totalCommissionNum - withdrawnNum - pendingWithdrawNum

2. 详细日志输出

console.log('=== [Referral] 收益计算（完整版）===')
console.log('累计佣金 (totalCommission):', totalCommissionNum)
console.log('已提现金额 (withdrawnEarnings):', withdrawnNum)
console.log('待审核金额 (pendingWithdrawAmount):', pendingWithdrawNum)
console.log('可提现金额 = 累计 - 已提现 - 待审核 =', totalCommissionNum, '-', withdrawnNum, '-', pendingWithdrawNum, '=', availableEarningsNum)
console.log('最低提现金额 (minWithdrawAmount):', minWithdrawAmount)
console.log('按钮判断:', availableEarningsNum, '>=', minWithdrawAmount, '=', availableEarningsNum >= minWithdrawAmount)
console.log('✅ 按钮应该:', availableEarningsNum >= minWithdrawAmount ? '🟢 启用(绿色)' : '⚫ 禁用(灰色)')

验证流程

完整场景测试

场景1：初始状态

数据：
- 累计佣金: ¥100
- 已提现: ¥0
- 待审核: ¥0

计算：
availableEarnings = 100 - 0 - 0 = ¥100

验证：✅ 可提现 ¥100

场景2：申请提现

操作：申请提现 ¥50

数据：
- 累计佣金: ¥100 (不变)
- 已提现: ¥0 (不变)
- 待审核: ¥50 (新增)

计算：
availableEarnings = 100 - 0 - 50 = ¥50

验证：✅ 可提现 ¥50

场景3：审核通过（关键）

操作：管理员审核通过

数据：
- 累计佣金: ¥100 (不变)
- 已提现: ¥50 (users.withdrawn_earnings += 50)
- 待审核: ¥0 (状态改为 completed)

计算：
availableEarnings = 100 - 50 - 0 = ¥50

验证：✅ 可提现 ¥50（不会回血！）

场景4：新订单产生

操作：用户购买新商品，产生佣金 ¥20

数据：
- 累计佣金: ¥120 (100 + 20)
- 已提现: ¥50 (不变)
- 待审核: ¥0 (不变)

计算：
availableEarnings = 120 - 50 - 0 = ¥70

验证：✅ 可提现 ¥70

场景5：二次提现

操作：申请提现 ¥30

数据：
- 累计佣金: ¥120 (不变)
- 已提现: ¥50 (不变)
- 待审核: ¥30 (新增)

计算：
availableEarnings = 120 - 50 - 30 = ¥40

验证：✅ 可提现 ¥40

数据库验证

1. 检查 users 表

SELECT 
  id, 
  nickname,
  withdrawn_earnings
FROM users 
WHERE id = 'YOUR_USER_ID';

2. 检查 withdrawals 表

SELECT 
  id,
  amount,
  status,
  created_at
FROM withdrawals 
WHERE user_id = 'YOUR_USER_ID'
ORDER BY created_at DESC;

3. 检查 orders 表

SELECT 
  SUM(amount) as total_amount
FROM orders 
WHERE referrer_id = 'YOUR_USER_ID' 
  AND status = 'paid';

4. 手动验证计算

-- 1. 累计佣金
SET @total_orders = (SELECT SUM(amount) FROM orders WHERE referrer_id = 'YOUR_USER_ID' AND status = 'paid');
SET @distributor_share = 0.9;
SET @total_commission = @total_orders * @distributor_share;

-- 2. 已提现
SET @withdrawn = (SELECT withdrawn_earnings FROM users WHERE id = 'YOUR_USER_ID');

-- 3. 待审核
SET @pending = (SELECT SUM(amount) FROM withdrawals WHERE user_id = 'YOUR_USER_ID' AND status = 'pending');

-- 4. 可提现
SET @available = @total_commission - @withdrawn - IFNULL(@pending, 0);

-- 显示结果
SELECT 
  @total_commission as '累计佣金',
  @withdrawn as '已提现',
  @pending as '待审核',
  @available as '可提现';

测试步骤

1. 清除缓存重新编译

微信开发者工具：

工具 → 清除缓存 → 清除全部缓存数据
点击 编译 按钮

2. 查看控制台日志

进入分销中心页面，查看日志输出：

=== [Referral] 收益计算（完整版）===
累计佣金 (totalCommission): 100
已提现金额 (withdrawnEarnings): 0
待审核金额 (pendingWithdrawAmount): 0
可提现金额 = 累计 - 已提现 - 待审核 = 100 - 0 - 0 = 100
最低提现金额 (minWithdrawAmount): 5
按钮判断: 100 >= 5 = true
✅ 按钮应该: 🟢 启用(绿色)

3. 测试提现流程

1. 申请提现：点击提现按钮，申请提现
2. 查看变化：
   • 累计佣金不变
   • 待审核金额增加
   • 可提现金额减少
3. 审核通过：在管理后台审核通过
4. 再次查看：
   • 累计佣金不变
   • 已提现金额增加
   • 待审核金额归零
   • 可提现金额不应该回血

4. 验证按钮状态

不同情况下按钮的状态：

可提现金额	最低提现	按钮状态	按钮文本
¥10	¥5	启用	申请提现 ¥10
¥3	¥5	禁用	满5元可提现
¥0	¥5	禁用	满5元可提现

常见问题

Q1: 为什么要分"累计佣金"和"可提现金额"？

A:

• 累计佣金：用户的成就感，"我总共赚了多少"
• 可提现金额：用户的可操作余额，"我现在能提多少"

Q2: 已提现的钱还算在累计佣金里吗？

A: 是的。累计佣金是历史总和，只增不减。已提现只是资金流向，不影响累计数字。

示例：

• 累计赚了 ¥100（成就）
• 已提现 ¥50（已到手）
• 还能提现 ¥50（余额）

Q3: 如果审核拒绝会怎样？

A:

1. 待审核金额归零（提现申请被取消）
2. 已提现金额不变
3. 可提现金额恢复（用户可以重新申请）

Q4: users.withdrawn_earnings 会自动更新吗？

A: 是的，在两个地方会更新：

• app/api/withdraw/route.ts - 自动审核通过时
• app/api/admin/withdrawals/route.ts - 管理员审核通过时

Q5: 为什么不直接从数据库读取可提现金额？

A:

• 可提现金额是动态计算值，不是固定字段
• 实时计算确保数据准确
• 便于调试和验证逻辑

相关文件

• miniprogram/pages/referral/referral.js - 前端计算（已修改）✅
• app/api/referral/data/route.ts - 数据查询（无需修改）
• app/api/withdraw/route.ts - 提现接口（无需修改）
• app/api/admin/withdrawals/route.ts - 审核接口（无需修改）

数据流图

┌────────────────────────────────────────────┐
│              订单产生佣金                  │
│                   ↓                        │
│        累计佣金 (totalCommission)          │
│            持续累加，只增不减               │
│                   ↓                        │
│     ┌─────────────┴─────────────┐          │
│     ↓                           ↓          │
│  申请提现                    继续积累       │
│     ↓                                      │
│  待审核 (pendingWithdrawAmount)            │
│  暂时冻结                                  │
│     ↓                                      │
│  审核通过                                  │
│     ↓                                      │
│  已提现 (withdrawnEarnings)                │
│  累加记录                                  │
│                                            │
│  ┌─────────────────────────┐               │
│  │   可提现金额（实时计算）  │               │
│  │ = 累计佣金               │               │
│  │   - 已提现金额           │               │
│  │   - 待审核金额           │               │
│  └─────────────────────────┘               │
└────────────────────────────────────────────┘

总结

修改前的问题

❌ 可提现 = 累计佣金 - 待审核金额

问题：审核通过后，待审核归零，可提现"回血"

修改后的正确逻辑

✅ 可提现 = 累计佣金 - 已提现金额 - 待审核金额

优点：
1. 审核通过后，可提现金额不会增加
2. 只有新订单产生佣金时，可提现金额才会增加
3. 逻辑清晰，符合资金流向

业务含义

• 累计佣金：成就感 - "我赚了多少"
• 已提现：安全感 - "我拿到了多少"
• 待审核：期待感 - "我正在提多少"
• 可提现：行动力 - "我能提多少"

这样的设计既满足了用户查看历史成就的需求，又确保了资金安全和准确性。