107 lines
2.9 KiB
Markdown
107 lines
2.9 KiB
Markdown
|
# 数据同步问题诊断和解决方案
|
|||
|
|
|
|||
|
|
## 问题分析
|
|||
|
|
|
|||
|
|
根据用户提供的图片，我们发现了以下问题：
|
|||
|
|
|
|||
|
|
### 1. iot_device_data表中有数据
|
|||
|
|
- 设备ID: 24075000139
|
|||
|
|
- 电压: 3.300
|
|||
|
|
- 温度: 25.80
|
|||
|
|
- 设备类型: 4 (项圈)
|
|||
|
|
- 运送订单ID: 86
|
|||
|
|
|
|||
|
|
### 2. xq_client_log表中数据为空
|
|||
|
|
- device_voltage字段: (Null)
|
|||
|
|
- device_temp字段: (Null)
|
|||
|
|
- server_device_id字段: (Null)
|
|||
|
|
|
|||
|
|
## 问题原因
|
|||
|
|
|
|||
|
|
1. **字段映射不匹配**: xq_client_log表的实际字段结构与我们的实体类不匹配
|
|||
|
|
2. **数据同步未执行**: 60分钟定时任务可能还没有执行，或者手动同步失败
|
|||
|
|
3. **字段长度限制**: latitude字段长度不够，导致数据截断错误
|
|||
|
|
|
|||
|
|
## 解决方案
|
|||
|
|
|
|||
|
|
### 1. 修复字段映射问题
|
|||
|
|
|
|||
|
|
我们已经修改了 `XqClientLogMapper.xml`，建立了正确的字段映射：
|
|||
|
|
|
|||
|
|
| 实际表字段 | 实体类属性 | 说明 |
|
|||
|
|
|-----------|-----------|------|
|
|||
|
|
| `battery` | `deviceVoltage` | 电池电量→设备电压 |
|
|||
|
|
| `temperature` | `deviceTemp` | 温度 |
|
|||
|
|
| `deviceld` | `serverDeviceId` | 设备长ID→主机设备ID |
|
|||
|
|
| `steps` | `walkSteps` | 步数 |
|
|||
|
|
| `time` | `createTime/updateTime` | 时间字段 |
|
|||
|
|
|
|||
|
|
### 2. 修复字段长度问题
|
|||
|
|
|
|||
|
|
创建了SQL脚本 `fix_xq_client_log_field_length.sql` 来扩展字段长度：
|
|||
|
|
- latitude: VARCHAR(50)
|
|||
|
|
- longitude: VARCHAR(50)
|
|||
|
|
- device_voltage: VARCHAR(50)
|
|||
|
|
- device_temp: VARCHAR(50)
|
|||
|
|
|
|||
|
|
### 3. 手动触发数据同步
|
|||
|
|
|
|||
|
|
使用API接口手动触发同步：
|
|||
|
|
```bash
|
|||
|
|
POST http://localhost:8080/api/deliveryDevice/manualSyncDeviceLogs
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 测试步骤
|
|||
|
|
|
|||
|
|
### 1. 执行数据库修复脚本
|
|||
|
|
```sql
|
|||
|
|
-- 执行 fix_xq_client_log_field_length.sql
|
|||
|
|
-- 扩展字段长度，避免数据截断
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 手动触发数据同步
|
|||
|
|
```bash
|
|||
|
|
# 等待应用完全启动后
|
|||
|
|
Invoke-WebRequest -Uri "http://localhost:8080/api/deliveryDevice/manualSyncDeviceLogs" -Method POST
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 验证同步结果
|
|||
|
|
```sql
|
|||
|
|
-- 检查xq_client_log表中是否有新数据
|
|||
|
|
SELECT * FROM xq_client_log WHERE device_id = '24075000139' ORDER BY time DESC LIMIT 10;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 检查同步统计
|
|||
|
|
```bash
|
|||
|
|
# 获取同步统计信息
|
|||
|
|
Invoke-WebRequest -Uri "http://localhost:8080/api/deliveryDevice/getLogSyncStatistics" -Method GET
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 预期结果
|
|||
|
|
|
|||
|
|
同步成功后，xq_client_log表应该包含：
|
|||
|
|
- device_id: 24075000139
|
|||
|
|
- battery: 3.300 (来自iot_device_data.voltage)
|
|||
|
|
- temperature: 25.80 (来自iot_device_data.temperature)
|
|||
|
|
- steps: 21 (来自iot_device_data.steps)
|
|||
|
|
- latitude: 30.4812778
|
|||
|
|
- longitude: 114.401791
|
|||
|
|
- time: 当前时间
|
|||
|
|
|
|||
|
|
## 故障排除
|
|||
|
|
|
|||
|
|
如果同步仍然失败，请检查：
|
|||
|
|
|
|||
|
|
1. **应用日志**: 查看控制台输出，确认同步过程中的错误信息
|
|||
|
|
2. **数据库连接**: 确认应用能够正常连接数据库
|
|||
|
|
3. **字段权限**: 确认数据库用户有INSERT权限
|
|||
|
|
4. **数据格式**: 确认数据类型转换正确
|
|||
|
|
|
|||
|
|
## 下一步
|
|||
|
|
|
|||
|
|
1. 等待应用完全启动
|
|||
|
|
2. 执行数据库修复脚本
|
|||
|
|
3. 手动触发数据同步
|
|||
|
|
4. 验证同步结果
|
|||
|
|
5. 测试日志查询和轨迹功能
|