peixue-dev/Archive/[一次性]积分功能修复完成-2026-01-31.md

# 积分功能修复完成 - 2026-01-31

## 问题描述

用户反馈积分页面显示问题:
1. **累计获得显示为0** - 即使有积分记录,累计获得仍然显示0
2. **积分明细显示正常** - 能看到"注册赠送"、"签到赠送"等记录

## 问题原因

### 根本原因
后端 `PointsServiceImpl.java` 的 `addPoints` 和 `deductPoints` 方法使用了错误的字段:

**错误代码:**
```java
// 使用了虚拟字段
userPoints.setTotalPoints(userPoints.getTotalPoints() + points);
userPoints.setAvailablePoints(userPoints.getAvailablePoints() + points);
```

**数据库实际字段:**
- `balance` - 当前余额
- `totalEarned` - 累计获得
- `totalSpent` - 累计消费

**虚拟字段(不存在于数据库):**
- `totalPoints` - 虚拟字段
- `availablePoints` - 虚拟字段
- `usedPoints` - 虚拟字段

### 问题影响
1. 增加积分时,只更新了虚拟字段,数据库的 `totalEarned` 字段没有更新
2. 前端读取 `totalEarned` 字段,所以显示为0
3. 积分记录表 `points_record` 正常,所以明细显示正常

## 修复方案

### 1. 修改后端代码

修改 `PointsServiceImpl.java` 的以下方法:

#### initUserPoints - 初始化用户积分
```java
// 修改前
userPoints.setTotalPoints(0);
userPoints.setAvailablePoints(0);
userPoints.setUsedPoints(0);

// 修改后
userPoints.setBalance(0);
userPoints.setTotalEarned(0);
userPoints.setTotalSpent(0);
```

#### addPoints - 增加积分
```java
// 修改前
userPoints.setTotalPoints(userPoints.getTotalPoints() + points);
userPoints.setAvailablePoints(userPoints.getAvailablePoints() + points);

// 修改后
userPoints.setBalance(userPoints.getBalance() + points);
userPoints.setTotalEarned(userPoints.getTotalEarned() + points);
```

#### deductPoints - 扣减积分
```java
// 修改前
userPoints.setAvailablePoints(userPoints.getAvailablePoints() - points);
userPoints.setUsedPoints(userPoints.getUsedPoints() + points);

// 修改后
userPoints.setBalance(userPoints.getBalance() - points);
userPoints.setTotalSpent(userPoints.getTotalSpent() + points);
```

#### getPointsStatistics - 获取积分统计
```java
// 修改前
stats.put("totalPoints", userPoints.getTotalPoints());
stats.put("availablePoints", userPoints.getAvailablePoints());
stats.put("usedPoints", userPoints.getUsedPoints());

// 修改后
stats.put("totalPoints", userPoints.getTotalEarned());
stats.put("availablePoints", userPoints.getBalance());
stats.put("usedPoints", userPoints.getTotalSpent());
```

### 2. 修复已有数据

执行SQL脚本修复现有用户的积分统计数据:

```sql
-- 根据 points_record 表重新计算
UPDATE user_points up
SET totalEarned = (
    SELECT COALESCE(SUM(points), 0)
    FROM points_record pr
    WHERE pr.user_id = up.user_id AND pr.type = 'earn'
);

UPDATE user_points up
SET totalSpent = (
    SELECT COALESCE(SUM(ABS(points)), 0)
    FROM points_record pr
    WHERE pr.user_id = up.user_id AND pr.type IN ('consume', 'spend')
);

UPDATE user_points
SET balance = totalEarned - totalSpent;
```

## 执行步骤

### 1. 修复数据库数据
```bash
执行: Archive/[一次性]执行修复积分统计-2026-01-31.bat
```

### 2. 重启后端服务
```bash
执行: Archive/[一次性]重启后端服务-积分修复-2026-01-31.bat
```

### 3. 清除小程序缓存
```bash
执行: Archive/[一次性]清除缓存重新编译-积分修复-2026-01-31.bat
```

## 验证结果

修复后,积分页面应该正常显示:
- ✅ 累计获得 - 显示正确的累计积分数
- ✅ 累计使用 - 显示正确的消费积分数
- ✅ 当前余额 - 显示正确的可用积分
- ✅ 积分明细 - 继续正常显示

## 注意事项

1. **字段映射关系:**
   - 数据库 `balance` = 前端显示的"我的积分"
   - 数据库 `totalEarned` = 前端显示的"累计获得"
   - 数据库 `totalSpent` = 前端显示的"累计使用"

2. **虚拟字段:**
   - `UserPoints` 实体类中的虚拟字段仅用于兼容旧代码
   - 标记为 `@TableField(exist = false)`,不会写入数据库
   - 新代码应该使用真实字段

3. **数据一致性:**
   - 修复脚本会根据 `points_record` 表重新计算统计数据
   - 确保 `balance = totalEarned - totalSpent`

## 修复文件清单

- ✅ `peidu/backend/src/main/java/com/peidu/service/impl/PointsServiceImpl.java` - 后端代码修复
- ✅ `Archive/[一次性]修复积分统计数据-2026-01-31.sql` - 数据修复脚本
- ✅ `Archive/[一次性]执行修复积分统计-2026-01-31.bat` - 执行脚本
- ✅ `Archive/[一次性]重启后端服务-积分修复-2026-01-31.bat` - 重启脚本

## 修复完成时间

2026-01-31