122 lines
3.6 KiB
Markdown
122 lines
3.6 KiB
Markdown
|
# 签到地址显示修复完成
|
|||
|
|
|
|||
|
|
## 问题描述
|
|||
|
|
|
|||
|
|
陪伴员签到签退功能中，地址显示为 "453535" 等无效数字，而不是真实的地理位置（如：安徽省合肥市蜀山区xxx）。
|
|||
|
|
|
|||
|
|
## 问题原因
|
|||
|
|
|
|||
|
|
1. **数据库问题**：`order` 表的 `service_address` 字段存储了无效数据（纯数字）
|
|||
|
|
2. **前端逻辑问题**：代码优先使用订单地址，即使是无效的纯数字也会显示
|
|||
|
|
|
|||
|
|
## 解决方案
|
|||
|
|
|
|||
|
|
### 1. 前端修复（已完成）
|
|||
|
|
|
|||
|
|
修改了 3 个签到页面，添加地址有效性检测：
|
|||
|
|
|
|||
|
|
#### ✅ `peidu/uniapp/src/teacher-package/pages/teacher/checkin.vue`
|
|||
|
|
- 在 `getAddress()` 方法中添加地址验证
|
|||
|
|
- 检测纯数字地址，自动使用逆地理编码
|
|||
|
|
|
|||
|
|
#### ✅ `peidu/uniapp/teacher-package/pages/teacher/watermark-checkin.vue`
|
|||
|
|
- 在 `loadOrderInfo()` 方法中添加地址验证
|
|||
|
|
- 无效地址设为空字符串，避免显示
|
|||
|
|
|
|||
|
|
#### ✅ `peidu/uniapp/src/teacher-package/pages/teacher/checkout.vue`
|
|||
|
|
- 在 `getAddress()` 方法中添加地址验证
|
|||
|
|
- 检测纯数字地址，自动使用逆地理编码
|
|||
|
|
|
|||
|
|
### 2. 地址验证逻辑
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// 检查地址是否有效（不是纯数字、不为空）
|
|||
|
|
const orderAddress = this.orderInfo?.serviceAddress
|
|||
|
|
const isValidAddress = orderAddress &&
|
|||
|
|
orderAddress.trim() !== '' &&
|
|||
|
|
!/^\d+$/.test(orderAddress.trim())
|
|||
|
|
|
|||
|
|
if (isValidAddress) {
|
|||
|
|
// 使用订单地址
|
|||
|
|
this.address = orderAddress
|
|||
|
|
} else {
|
|||
|
|
// 使用逆地理编码获取真实地址
|
|||
|
|
const result = await reverseGeocode(lat, lng)
|
|||
|
|
this.address = result.address
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 数据库修复（待执行）
|
|||
|
|
|
|||
|
|
执行 SQL 脚本清理无效地址：
|
|||
|
|
```bash
|
|||
|
|
peidu/Archive/一次性文件/[一次性]修复订单地址数据-2026-01-26.sql
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
该脚本会将纯数字地址更新为 NULL，让前端自动使用逆地理编码。
|
|||
|
|
|
|||
|
|
## 配置要求
|
|||
|
|
|
|||
|
|
### 微信小程序域名白名单
|
|||
|
|
|
|||
|
|
需要在微信小程序后台添加以下域名到 request 合法域名：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
https://apis.map.qq.com
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**配置路径：**
|
|||
|
|
微信公众平台 → 开发 → 开发管理 → 开发设置 → 服务器域名 → request合法域名
|
|||
|
|
|
|||
|
|
### 腾讯地图 API Key
|
|||
|
|
|
|||
|
|
已配置在 `peidu/uniapp/src/config/map.js`：
|
|||
|
|
```javascript
|
|||
|
|
key: 'Q7CBZ-CC2C5-5O6IA-IU5VM-KJGAF-IKBRO'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 测试步骤
|
|||
|
|
|
|||
|
|
1. **编译小程序**
|
|||
|
|
```bash
|
|||
|
|
cd peidu/uniapp
|
|||
|
|
npm run dev:mp-weixin
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **测试签到功能**
|
|||
|
|
- 进入陪伴员端
|
|||
|
|
- 点击"签到签退"
|
|||
|
|
- 查看地址显示是否为：安徽省合肥市蜀山区xxx
|
|||
|
|
|
|||
|
|
3. **测试订单签到**
|
|||
|
|
- 进入待服务订单
|
|||
|
|
- 点击"开始服务"
|
|||
|
|
- 查看地址显示是否正确
|
|||
|
|
|
|||
|
|
## 预期效果
|
|||
|
|
|
|||
|
|
- ✅ 地址显示为：安徽省合肥市蜀山区xxx（具体到街道）
|
|||
|
|
- ✅ 不再显示纯数字（如：453535）
|
|||
|
|
- ✅ 自动使用逆地理编码获取真实位置
|
|||
|
|
- ✅ 控制台输出详细日志，便于调试
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. **首次使用需要授权定位权限**
|
|||
|
|
2. **需要在真机上测试**（模拟器可能无法获取位置）
|
|||
|
|
3. **确保网络连接正常**（需要调用腾讯地图API）
|
|||
|
|
4. **建议执行数据库修复脚本**，清理历史无效数据
|
|||
|
|
|
|||
|
|
## 相关文件
|
|||
|
|
|
|||
|
|
- `peidu/uniapp/src/config/map.js` - 地图配置和工具函数
|
|||
|
|
- `peidu/uniapp/src/teacher-package/pages/teacher/checkin.vue` - 签到页面
|
|||
|
|
- `peidu/uniapp/teacher-package/pages/teacher/watermark-checkin.vue` - 水印签到页面
|
|||
|
|
- `peidu/uniapp/src/teacher-package/pages/teacher/checkout.vue` - 签退页面
|
|||
|
|
- `peidu/Archive/一次性文件/[一次性]修复订单地址数据-2026-01-26.sql` - 数据库修复脚本
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**修复完成时间：** 2026-01-26
|
|||
|
|
**修复人员：** Kiro AI
|