1
This commit is contained in:
237
doc/手机号码功能详细排查指南.md
Normal file
237
doc/手机号码功能详细排查指南.md
Normal file
@@ -0,0 +1,237 @@
|
||||
# 手机号码功能详细排查指南
|
||||
|
||||
## ✅ 已确认信息
|
||||
|
||||
- **表头列名**: `下单电话` （严格匹配）
|
||||
- **数据字段**: `status` （订单的status字段存储手机号码）
|
||||
- **示例数据**: `17703916233`
|
||||
|
||||
## 🔍 增强的日志输出
|
||||
|
||||
现在代码中已经添加了详细的DEBUG和INFO日志，重新编译部署后，您会看到以下完整的日志链路：
|
||||
|
||||
### 1️⃣ 表头列识别日志
|
||||
|
||||
```log
|
||||
开始识别表头列，共 26 列
|
||||
列 0 内容: [日期]
|
||||
列 1 内容: [公司]
|
||||
列 2 内容: [单号]
|
||||
✓ 识别到 '单号' 列：第 3 列（索引2）
|
||||
列 3 内容: [型号]
|
||||
列 4 内容: [数量]
|
||||
列 5 内容: [姓名]
|
||||
列 6 内容: [下单电话]
|
||||
✓ 识别到 '下单电话' 列：第 7 列（索引6），列名: [下单电话]
|
||||
...
|
||||
表头列识别完成
|
||||
列位置识别完成 - 单号: 2, 物流单号: 12, 是否安排: null, 标记: 14, 下单电话: 6
|
||||
```
|
||||
|
||||
**✅ 关键检查点：**
|
||||
- 必须看到 `✓ 识别到 '下单电话' 列` 这一行
|
||||
- 最后一行 `下单电话: 6` **不能是null**
|
||||
|
||||
### 2️⃣ 手机号提取日志
|
||||
|
||||
```log
|
||||
准备从status字段提取手机号 - 单号: JY202511061595, status内容: [17703916233]
|
||||
原始文本: [17703916233]
|
||||
清理后文本: [17703916233]
|
||||
成功提取手机号码: [17703916233] <- 原文本: [17703916233]
|
||||
✓ 从status字段提取手机号码 - 单号: JY202511061595, status: [17703916233], 手机号: 17703916233
|
||||
```
|
||||
|
||||
**✅ 关键检查点：**
|
||||
- 必须看到 `成功提取手机号码` 这一行
|
||||
- status内容不能为空
|
||||
|
||||
### 3️⃣ 准备写入日志
|
||||
|
||||
```log
|
||||
✓ 准备写入手机号码 - 单号: JY202511061595, 手机号: 17703916233, 行: 2575, 列: 6
|
||||
```
|
||||
|
||||
### 4️⃣ batchUpdate请求体日志
|
||||
|
||||
```json
|
||||
批量更新表格 - 请求体: {
|
||||
"requests":[
|
||||
{"updateRangeRequest":{"sheetId":"BB08J2","gridData":{"startRow":2574,"startColumn":12,
|
||||
"rows":[{"values":[{"cellValue":{"link":{"url":"https://3.cn/xxx","text":"https://3.cn/xxx"}}}]}]}}},
|
||||
{"updateRangeRequest":{"sheetId":"BB08J2","gridData":{"startRow":2574,"startColumn":6, <-- 手机号列
|
||||
"rows":[{"values":[{"cellValue":{"text":"17703916233"}}]}]}}},
|
||||
{"updateRangeRequest":{"sheetId":"BB08J2","gridData":{"startRow":2574,"startColumn":14,
|
||||
"rows":[{"values":[{"cellValue":{"text":"251106"}}]}]}}}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**✅ 关键检查点：**
|
||||
- `requests` 数组应该有 **3个元素**（物流、手机号、标记）
|
||||
- 其中一个 `startColumn` 应该是 **6**（如果下单电话在第7列）
|
||||
|
||||
### 5️⃣ 写入成功日志
|
||||
|
||||
```log
|
||||
✓ 写入成功 - 行: 2575, 单号: JY202511061595, 物流链接: https://3.cn/xxx, 手机号: 17703916233
|
||||
```
|
||||
|
||||
## 🎯 部署和测试步骤
|
||||
|
||||
### 步骤1: 重新编译后端
|
||||
|
||||
```bash
|
||||
cd d:\code\RuoYi-Vue-master\ruoyi-java
|
||||
mvn clean package -DskipTests
|
||||
```
|
||||
|
||||
### 步骤2: 重启后端服务
|
||||
|
||||
确保服务完全重启，加载了新的代码。
|
||||
|
||||
### 步骤3: 启用DEBUG日志（可选，推荐）
|
||||
|
||||
如果想看到更详细的日志，修改 `application.yml` 或 `logback.xml`：
|
||||
|
||||
```yaml
|
||||
logging:
|
||||
level:
|
||||
com.ruoyi.web.controller.jarvis.TencentDocController: DEBUG
|
||||
```
|
||||
|
||||
### 步骤4: 执行批量同步
|
||||
|
||||
1. 打开订单列表页面
|
||||
2. 点击"批量同步物流"按钮
|
||||
3. 确认同步
|
||||
|
||||
### 步骤5: 查看日志
|
||||
|
||||
查看后端日志，按照上面的 5️⃣ 个关键节点逐一检查。
|
||||
|
||||
## 🐛 问题排查流程
|
||||
|
||||
### 问题A: 没有识别到"下单电话"列
|
||||
|
||||
**症状：**
|
||||
```log
|
||||
列位置识别完成 - 单号: 2, 物流单号: 12, 是否安排: null, 标记: 14, 下单电话: null
|
||||
```
|
||||
|
||||
**排查：**
|
||||
1. 查看前面的 `列 X 内容: [XXX]` 日志，找到所有列名
|
||||
2. 确认是否真的有一列叫 "下单电话"
|
||||
3. 检查列名是否有额外的空格或特殊字符
|
||||
4. 如果列名是 "电话" 或 "手机"，也应该能识别
|
||||
|
||||
**解决：**
|
||||
- 如果列名不匹配，在腾讯文档中将该列重命名为 "下单电话"
|
||||
- 或者修改代码，添加更多匹配规则
|
||||
|
||||
### 问题B: 识别到列但没有提取到手机号
|
||||
|
||||
**症状：**
|
||||
```log
|
||||
✓ 识别到 '下单电话' 列：第 7 列（索引6），列名: [下单电话]
|
||||
...
|
||||
phoneColumn为null，跳过手机号提取 - 单号: JY202511061595
|
||||
```
|
||||
|
||||
**这个不应该发生！** 如果识别到了列，`phoneColumn` 就不应该是null。
|
||||
|
||||
**排查：**
|
||||
- 检查是否有异常日志
|
||||
- 可能是代码逻辑问题
|
||||
|
||||
### 问题C: status字段为空或不包含手机号
|
||||
|
||||
**症状：**
|
||||
```log
|
||||
准备从status字段提取手机号 - 单号: JY202511061595, status内容: []
|
||||
或
|
||||
准备从status字段提取手机号 - 单号: JY202511061595, status内容: [其他内容，没有手机号]
|
||||
未找到匹配的手机号码，文本: [其他内容]
|
||||
```
|
||||
|
||||
**排查：**
|
||||
1. 确认订单的status字段确实存储了手机号码
|
||||
2. 检查数据库中该订单的status值
|
||||
3. 可能某些订单的status字段不包含手机号
|
||||
|
||||
**解决：**
|
||||
- 确保所有需要同步的订单，其status字段都包含11位手机号码
|
||||
- 如果status字段用于其他用途，可能需要调整数据结构
|
||||
|
||||
### 问题D: 提取成功但请求体中没有手机号字段
|
||||
|
||||
**症状：**
|
||||
```log
|
||||
✓ 从status字段提取手机号码 - 单号: JY202511061595, status: [17703916233], 手机号: 17703916233
|
||||
...
|
||||
批量更新表格 - 请求体: {"requests":[...]} <-- 只有2个updateRangeRequest
|
||||
```
|
||||
|
||||
**排查：**
|
||||
- 查看 `✓ 准备写入手机号码` 日志是否存在
|
||||
- 检查代码逻辑，update对象是否正确构建
|
||||
|
||||
### 问题E: 写入请求发送但腾讯文档没有显示
|
||||
|
||||
**症状：**
|
||||
日志显示写入成功，但腾讯文档中"下单电话"列仍然为空。
|
||||
|
||||
**排查：**
|
||||
1. 检查API响应，是否真的返回 `updatedCells: 1`
|
||||
2. 刷新腾讯文档页面
|
||||
3. 检查列索引是否正确（可能写到了其他列）
|
||||
4. 检查该列是否有格式限制或保护
|
||||
|
||||
## 📊 完整日志示例（成功场景）
|
||||
|
||||
```log
|
||||
22:03:29.150 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 开始读取表头 - 行号: 2, range: A2:Z2
|
||||
22:03:29.259 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 开始识别表头列，共 26 列
|
||||
22:03:29.259 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 列 0 内容: [日期]
|
||||
22:03:29.259 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 列 1 内容: [公司]
|
||||
22:03:29.259 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 列 2 内容: [单号]
|
||||
22:03:29.259 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - ✓ 识别到 '单号' 列：第 3 列（索引2）
|
||||
22:03:29.259 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 列 6 内容: [下单电话]
|
||||
22:03:29.259 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - ✓ 识别到 '下单电话' 列：第 7 列（索引6），列名: [下单电话]
|
||||
22:03:29.259 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 表头列识别完成
|
||||
22:03:29.259 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 列位置识别完成 - 单号: 2, 物流单号: 12, 是否安排: null, 标记: 14, 下单电话: 6
|
||||
|
||||
... (读取数据行) ...
|
||||
|
||||
22:03:29.500 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 准备从status字段提取手机号 - 单号: JY202511061595, status内容: [17703916233]
|
||||
22:03:29.500 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 原始文本: [17703916233]
|
||||
22:03:29.500 [http-nio-30313-exec-10] DEBUG c.r.w.c.j.TencentDocController - 清理后文本: [17703916233]
|
||||
22:03:29.500 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 成功提取手机号码: [17703916233] <- 原文本: [17703916233]
|
||||
22:03:29.500 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - ✓ 从status字段提取手机号码 - 单号: JY202511061595, status: [17703916233], 手机号: 17703916233
|
||||
22:03:29.500 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - 找到订单物流链接 - 单号: JY202511061595, 物流链接: https://3.cn/xxx, 手机号: 17703916233, 行号: 2575, 已推送: 否
|
||||
|
||||
... (批量写入) ...
|
||||
|
||||
22:03:29.700 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - ✓ 准备写入手机号码 - 单号: JY202511061595, 手机号: 17703916233, 行: 2575, 列: 6
|
||||
22:03:29.700 [http-nio-30313-exec-10] DEBUG c.r.j.u.TencentDocApiUtil - 批量更新表格 - 请求体: {"requests":[...3个updateRangeRequest...]}
|
||||
22:03:30.284 [http-nio-30313-exec-10] INFO c.r.w.c.j.TencentDocController - ✓ 写入成功 - 行: 2575, 单号: JY202511061595, 物流链接: https://3.cn/xxx, 手机号: 17703916233
|
||||
```
|
||||
|
||||
## 🎯 下一步行动
|
||||
|
||||
1. **重新编译部署**
|
||||
2. **执行一次批量同步**
|
||||
3. **复制完整日志**（从"开始识别表头列"到"写入成功"的所有日志）
|
||||
4. **提供给我分析**
|
||||
|
||||
如果还有问题，请提供：
|
||||
- ✅ 完整的表头识别日志（包括所有 `列 X 内容` 的DEBUG日志）
|
||||
- ✅ 手机号提取相关的所有日志
|
||||
- ✅ batchUpdate请求体的完整JSON
|
||||
- ✅ 腾讯文档表头的截图
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2025-11-06 22:30
|
||||
**版本**: v2.0 - 增强日志版
|
||||
|
||||
Reference in New Issue
Block a user