176 lines
5.6 KiB
Markdown
176 lines
5.6 KiB
Markdown
# 前端数据显示错误 + 存储过程返回数据异常 - 修复计划
|
||
|
||
## 问题诊断
|
||
|
||
### 观察到的现象
|
||
1. **后端API返回成功** (success: true)
|
||
2. **数据内容异常**：
|
||
- dailyNewReplaceCount: 0
|
||
- dailyShouldReplaceCount: 0
|
||
- dailySuccessCount: 0
|
||
- dailyCompletionRate: "0.00%"
|
||
- rate24Hour: "0.00%"
|
||
- 其他指标也为0或无意义
|
||
- 仅有 cumulativeTotal: 106 有数据
|
||
|
||
### 根本原因分析
|
||
1. **存储过程可能未创建或版本错误**
|
||
- 可能用户尚未在数据库中执行创建脚本
|
||
- 或者执行脚本时出现语法错误，但未被察觉
|
||
|
||
2. **存储过程返回空结果或默认值**
|
||
- 如果存储过程不存在，应该报错
|
||
- 但如果返回空结果集，应用层会返回默认值（全0）
|
||
|
||
3. **应用层降级处理**
|
||
- MetricsCalculationService.GetDailySummaryAsync 中如果存储过程失败，自动降级到 GetDailySummaryAsync_Original
|
||
- 但降级方法查询的是当前日期，不是查询参数的日期
|
||
|
||
4. **时区问题**
|
||
- 查询的日期与数据库中实际存在的日期可能不符
|
||
|
||
5. **前端日期选择问题**
|
||
- 用户选择的日期可能数据库中不存在
|
||
|
||
## 修复步骤
|
||
|
||
### 步骤1：验证存储过程是否存在
|
||
**目标**：确认存储过程是否正确创建
|
||
|
||
**操作**：
|
||
1. 在MySQL中执行：
|
||
```sql
|
||
SHOW PROCEDURE STATUS WHERE Db = 'lr01mainusa' AND Name = 'sp_GetDailyMetricsSummary';
|
||
```
|
||
2. 如果没有返回结果，说明存储过程未创建
|
||
3. 如果有返回结果，说明存储过程存在
|
||
|
||
### 步骤2：直接测试存储过程
|
||
**目标**：验证存储过程的输出数据
|
||
|
||
**操作**：
|
||
1. 执行：
|
||
```sql
|
||
CALL sp_GetDailyMetricsSummary('2026-05-17');
|
||
```
|
||
2. 检查返回的数据：
|
||
- 是否返回一行结果
|
||
- 各列的值是否合理（不都是0）
|
||
- 特别检查 DailyShouldReplaceCount 和 DailySuccessCount
|
||
|
||
### 步骤3：检查后端日期参数传递
|
||
**文件**：`src/CONTROLLER/Controllers/MetricsController.cs` 中的 `GetDailyDashboard` 方法
|
||
|
||
**检查内容**：
|
||
1. API是否正确接收查询参数 date
|
||
2. 是否正确传递给 MetricsCalculationService.GetDailySummaryAsync(date)
|
||
3. 日期格式是否正确（应为 yyyy-MM-dd）
|
||
|
||
### 步骤4：添加应用层日志调试
|
||
**文件**：`src/BLL/Services/MetricsCalculationService.cs`
|
||
|
||
**操作**：
|
||
在 GetDailySummaryAsync 方法中添加详细日志：
|
||
```csharp
|
||
_logger.LogInformation("Executing stored procedure with date: {date:yyyy-MM-dd}", date);
|
||
_logger.LogInformation("SQL query: {sql}", sql);
|
||
// 执行后添加
|
||
_logger.LogInformation("Stored procedure returned {count} rows", summaryList?.Count ?? 0);
|
||
if (summaryList?.Count > 0)
|
||
{
|
||
var firstRow = summaryList[0];
|
||
_logger.LogInformation("First row data: {data}", JsonConvert.SerializeObject(firstRow));
|
||
}
|
||
```
|
||
|
||
### 步骤5：前端错误处理修复
|
||
**文件**：`metrics-dashboard.html`
|
||
|
||
**问题**：前端显示error，但实际data存在（success: true）
|
||
|
||
**原因**：
|
||
1. 前端可能在处理全0数据时抛出错误
|
||
2. 或者在计算完成率时出现异常
|
||
|
||
**修复**：
|
||
1. 检查前端的数据验证逻辑
|
||
2. 添加对零值的容错处理
|
||
3. 显示友好的"暂无数据"提示而不是错误
|
||
|
||
### 步骤6：排查数据问题
|
||
**问题**：为什么只有 cumulativeTotal: 106，其他都是0？
|
||
|
||
**可能原因**：
|
||
1. 选择的日期（2026-05-17）在数据库中可能没有到仓记录（arrival_handover_forms）
|
||
2. 或者到仓记录的时间不在UTC-5转换后的当天
|
||
|
||
**验证SQL**：
|
||
```sql
|
||
-- 检查2026-05-17的到仓记录数
|
||
SELECT COUNT(*) as arrival_count,
|
||
COUNT(DISTINCT HandoverNumber) as unique_handover_count
|
||
FROM arrival_handover_forms
|
||
WHERE DATE(CONVERT_TZ(ReceiptTime, '+00:00', '-05:00')) = '2026-05-17';
|
||
|
||
-- 检查标签数据
|
||
SELECT COUNT(*) as label_count
|
||
FROM label_replace_requests
|
||
WHERE DATE(CONVERT_TZ(CreatedAt, '+00:00', '-05:00')) = '2026-05-17'
|
||
AND Label IS NOT NULL;
|
||
|
||
-- 检查扫描数据
|
||
SELECT COUNT(*) as scan_count
|
||
FROM label_scan_history
|
||
WHERE DATE(CONVERT_TZ(CreatedAt, '+00:00', '-05:00')) = '2026-05-17';
|
||
```
|
||
|
||
## 实现顺序
|
||
|
||
1. **验证存储过程** → 确认是否存在和可执行
|
||
2. **直接测试存储过程** → 验证输出数据
|
||
3. **检查API参数传递** → 确保日期正确传递
|
||
4. **添加应用层日志** → 调试返回的具体数据
|
||
5. **验证源数据** → 确认数据库中2026-05-17的实际数据
|
||
6. **修复前端错误处理** → 正确显示数据或提示
|
||
|
||
## 关键文件
|
||
|
||
### 需要检查的文件
|
||
1. `src/BLL/Services/MetricsCalculationService.cs` - GetDailySummaryAsync方法
|
||
2. `src/CONTROLLER/Controllers/MetricsController.cs` - GetDailyDashboard方法
|
||
3. `metrics-dashboard.html` - 前端数据处理逻辑
|
||
|
||
### 需要执行的SQL语句
|
||
- 验证存储过程存在性
|
||
- 直接调用存储过程测试
|
||
- 验证源数据是否存在
|
||
|
||
## 预期解决方案
|
||
|
||
### 情景A：存储过程未创建
|
||
1. 用户执行创建脚本
|
||
2. 重新测试
|
||
3. 问题解决
|
||
|
||
### 情景B：存储过程返回全0
|
||
1. 检查2026-05-17是否有实际数据
|
||
2. 修正存储过程中的时区转换或JOIN逻辑
|
||
3. 或选择有数据的日期重新测试
|
||
|
||
### 情景C：API未正确传递日期
|
||
1. 修改MetricsController中的参数传递逻辑
|
||
2. 确保日期格式正确
|
||
|
||
### 情景D：前端数据处理错误
|
||
1. 修复前端的数据验证和显示逻辑
|
||
2. 添加null/zero检查
|
||
|
||
## 验收标准
|
||
|
||
1. ✅ 存储过程成功创建并可执行
|
||
2. ✅ 直接测试存储过程返回非零数据
|
||
3. ✅ API返回合理的数据值（不都是0）
|
||
4. ✅ 前端正确显示数据或友好的"暂无数据"提示
|
||
5. ✅ 选择有数据的日期时，仪表盘显示完整指标
|
||
|