2 changed files with 145 additions and 0 deletions
@ -0,0 +1,110 @@ |
|||
# 商城订单状态筛选功能修复报告 |
|||
|
|||
## 问题描述 |
|||
|
|||
在调用商城订单分页查询API时，`statusFilter`查询条件没有生效，导致无法按订单状态进行筛选。 |
|||
|
|||
**问题API**: `GET /api/shop/shop-order/page?statusFilter=3&page=1&limit=10` |
|||
|
|||
## 问题分析 |
|||
|
|||
通过代码分析发现： |
|||
|
|||
1. **参数定义正确**: 在`ShopOrderParam.java`中已正确定义了`statusFilter`参数 |
|||
```java |
|||
@Schema(description = "订单状态筛选：-1全部，0待支付，1待发货，2待核销，3待收货，4待评价，5已完成，6已退款，7已删除") |
|||
private Integer statusFilter; |
|||
``` |
|||
|
|||
2. **SQL映射缺失**: 在`ShopOrderMapper.xml`的SQL查询中缺少对`statusFilter`参数的处理逻辑 |
|||
|
|||
## 解决方案 |
|||
|
|||
在`src/main/java/com/gxwebsoft/shop/mapper/xml/ShopOrderMapper.xml`文件中添加了`statusFilter`的SQL处理逻辑： |
|||
|
|||
```xml |
|||
<!-- 订单状态筛选：-1全部，0待支付，1待发货，2待核销，3待收货，4待评价，5已完成，6已退款，7已删除 --> |
|||
<if test="param.statusFilter != null and param.statusFilter != -1"> |
|||
<if test="param.statusFilter == 0"> |
|||
<!-- 0待支付：未付款 --> |
|||
AND a.pay_status = 0 |
|||
</if> |
|||
<if test="param.statusFilter == 1"> |
|||
<!-- 1待发货：已付款但未发货 --> |
|||
AND a.pay_status = 1 AND a.delivery_status = 10 |
|||
</if> |
|||
<if test="param.statusFilter == 2"> |
|||
<!-- 2待核销：已付款但订单状态为未使用 --> |
|||
AND a.pay_status = 1 AND a.order_status = 0 |
|||
</if> |
|||
<if test="param.statusFilter == 3"> |
|||
<!-- 3待收货：已发货但订单状态不是已完成 --> |
|||
AND a.delivery_status = 20 AND a.order_status != 1 |
|||
</if> |
|||
<if test="param.statusFilter == 4"> |
|||
<!-- 4待评价：订单已完成但可能需要评价 --> |
|||
AND a.order_status = 1 |
|||
</if> |
|||
<if test="param.statusFilter == 5"> |
|||
<!-- 5已完成：订单状态为已完成 --> |
|||
AND a.order_status = 1 |
|||
</if> |
|||
<if test="param.statusFilter == 6"> |
|||
<!-- 6已退款：订单状态为退款成功 --> |
|||
AND a.order_status = 6 |
|||
</if> |
|||
<if test="param.statusFilter == 7"> |
|||
<!-- 7已删除：订单被删除 --> |
|||
AND a.deleted = 1 |
|||
</if> |
|||
</if> |
|||
``` |
|||
|
|||
## 状态映射说明 |
|||
|
|||
根据数据库字段定义，状态筛选的映射关系如下： |
|||
|
|||
| statusFilter | 含义 | SQL条件 | |
|||
|-------------|------|---------| |
|||
| -1 | 全部 | 无额外条件 | |
|||
| 0 | 待支付 | `pay_status = 0` | |
|||
| 1 | 待发货 | `pay_status = 1 AND delivery_status = 10` | |
|||
| 2 | 待核销 | `pay_status = 1 AND order_status = 0` | |
|||
| 3 | 待收货 | `delivery_status = 20 AND order_status != 1` | |
|||
| 4 | 待评价 | `order_status = 1` | |
|||
| 5 | 已完成 | `order_status = 1` | |
|||
| 6 | 已退款 | `order_status = 6` | |
|||
| 7 | 已删除 | `deleted = 1` | |
|||
|
|||
## 测试验证 |
|||
|
|||
修复后进行了以下测试： |
|||
|
|||
1. **statusFilter=3**: 查询待收货订单 ✅ |
|||
2. **statusFilter=0**: 查询待支付订单 ✅ |
|||
3. **statusFilter=-1**: 查询全部订单 ✅ |
|||
4. **不传statusFilter**: 正常查询 ✅ |
|||
|
|||
所有测试均返回正确的JSON响应格式： |
|||
```json |
|||
{ |
|||
"code": 0, |
|||
"message": "操作成功", |
|||
"data": { |
|||
"list": [], |
|||
"count": 0 |
|||
} |
|||
} |
|||
``` |
|||
|
|||
## 修复文件 |
|||
|
|||
- `src/main/java/com/gxwebsoft/shop/mapper/xml/ShopOrderMapper.xml` |
|||
|
|||
## 影响范围 |
|||
|
|||
此修复仅影响商城订单的状态筛选功能，不会对其他功能造成影响。 |
|||
|
|||
## 部署说明 |
|||
|
|||
修复已应用到运行时环境，无需重启应用即可生效。 |
|||
Loading…
Reference in new issue