# 手机号码功能详细排查指南

## ✅ 已确认信息

- **表头列名**: `下单电话` （严格匹配）
- **数据字段**: `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 - 增强日志版

