忽略本地报错信息文件

2026-06-17 10:20:43 +08:00
parent 6b11144366
commit 090362c32d
191 changed files with 5434 additions and 76452 deletions
--- a/docs/home-service/FIX_dispatch_failure_guide.md
+++ b/docs/home-service/FIX_dispatch_failure_guide.md
@@ -0,0 +1,184 @@
+# 派单失败问题修复指南
+
+## 问题概述
+
+用户下单支付后，派单返回 `ALL_ELIGIBLE_STAFF_BUSY`（当前可服务人员均在忙），导致无法成功派单。
+
+## 根本原因
+
+### 原因 1：订单缺少服务经纬度（已修复）
+
+**问题**：`createServiceOrder` 函数在创建订单时，没有将地址的经纬度写入 `service_lat` 和 `service_lng` 字段。
+
+**影响**：
+- 派单 RPC 无法计算人员距离
+- 距离筛选条件失效
+- 可能匹配到远距离人员
+
+**修复**：`serviceOrderService.uts` 第 1181-1182 行新增：
+```typescript
+service_lat: params.address.latitude != null ? params.address.latitude : null,
+service_lng: params.address.longitude != null ? params.address.longitude : null,
+```
+
+### 原因 2：时间冲突检查过于严格（待数据库执行）
+
+**问题**：原 RPC 函数中，当订单 `scheduled_start_at` 或 `scheduled_end_at` 为 `NULL` 时，时间冲突检查条件会**跳过比较**，但 `NOT EXISTS` 子查询仍然会排除**任何有活跃任务**的人员。
+
+**原逻辑**（第 633-655 行）：
+```sql
+AND NOT EXISTS (
+    SELECT 1
+    FROM hss_service_assignments existing_assignment
+    JOIN hss_service_orders existing_order
+      ON existing_order.id = existing_assignment.order_id
+    WHERE existing_assignment.staff_id::TEXT = s.id::TEXT
+      AND existing_assignment.deleted_at IS NULL
+      AND existing_assignment.status IN ('assigned', 'accepted', ...)
+      AND (
+          v_order.scheduled_start_at IS NULL  -- 如果订单没有时间
+          OR v_order.scheduled_end_at IS NULL -- 则跳过比较
+          OR ...时间重叠判断...
+      )
+  )
+```
+
+**问题**：当 `v_order.scheduled_start_at IS NULL` 时，整个 `AND` 条件变为 `TRUE`，导致**所有有活跃任务的人员都被排除**。
+
+**修复**：新增优化版 RPC `rpc_homecare_auto_dispatch_optimized`，只有当订单有**明确时间范围**时才检查时间冲突。
+
+## 修复步骤
+
+### 第一步：执行诊断脚本（可选，用于确认问题）
+
+在 Supabase SQL Editor 中执行：
+```
+mall_sql/diagnostics/dispatch_failure_diagnosis.sql
+```
+
+重点关注：
+1. 问题订单的 `service_lat`/`service_lng` 是否为 `NULL`
+2. 有哪些服务人员在忙（有活跃派单记录）
+
+### 第二步：修复历史订单的经纬度
+
+在 Supabase SQL Editor 中执行：
+```
+mall_sql/migrations/20260610_fix_service_order_coordinates.sql
+```
+
+此脚本会：
+1. 统计有多少订单缺少经纬度
+2. 从 `address_snapshot_json` 中提取经纬度并更新到主表字段
+
+### 第三步：部署优化版派单 RPC
+
+在 Supabase SQL Editor 中执行：
+```
+mall_sql/migrations/20260610_optimize_dispatch_conflict_check.sql
+```
+
+此脚本会创建新的 RPC 函数 `rpc_homecare_auto_dispatch_optimized`。
+
+### 第四步：切换使用优化版 RPC ✅ 已完成
+
+修改前端调用优化版 RPC 函数。
+
+**文件**：`serviceOrderService.uts` 第 1015 行
+
+**修改前**：
+```typescript
+const { data, error } = await supa.rpc('rpc_homecare_auto_dispatch', {
+    p_order_id: orderId
+} as any)
+```
+
+**修改后**：
+```typescript
+const { data, error } = await supa.rpc('rpc_homecare_auto_dispatch_optimized', {
+    p_order_id: orderId
+} as any)
+```
+
+> ✅ 此步骤已完成，前端已切换使用优化版 RPC。
+
+## 验证方法
+
+### 1. 检查订单经纬度是否已填充
+
+```sql
+SELECT 
+    id,
+    service_lat,
+    service_lng,
+    address_snapshot_json->>'latitude' as address_lat,
+    address_snapshot_json->>'longitude' as address_lng
+FROM public.hss_service_orders
+WHERE id = 'so-1781054320183-35441';
+```
+
+### 2. 查看在线服务人员状态
+
+```sql
+SELECT 
+    id,
+    online_status,
+    station_id,
+    current_lat,
+    current_lng,
+    (SELECT COUNT(*) 
+     FROM hss_service_assignments sa
+     JOIN hss_service_orders so ON so.id = sa.order_id
+     WHERE sa.staff_id::TEXT = s.id::TEXT
+       AND sa.deleted_at IS NULL
+       AND sa.status IN ('assigned', 'accepted', 'departed', 'arrived', 'serving', 'in_service')
+    ) as active_tasks
+FROM ml_delivery_staff s
+WHERE deleted_at IS NULL
+  AND status = 1
+  AND COALESCE(is_active, TRUE) = TRUE
+ORDER BY online_status DESC, active_tasks ASC;
+```
+
+### 3. 前端测试流程
+
+1. 重新下单支付
+2. 查看控制台日志，应看到：
+   - `[homecare-dispatch] RPC response:` - RPC 原始返回
+   - `[homecare-dispatch] Parsed result:` - 解析后的结果
+   - `[confirmPayment] 派单结果:` - 支付页派单结果
+
+### 4. 预期结果
+
+**修复前**：
+```
+code: "ALL_ELIGIBLE_STAFF_BUSY"
+message: "当前可服务人员均在忙，请稍后重新派单"
+```
+
+**修复后**（如果有在线空闲人员）：
+```
+code: "DISPATCH_ASSIGNED"
+message: "系统已为您匹配服务人员"
+dispatch_status: "assigned"
+```
+
+## 文件清单
+
+| 文件 | 说明 |
+|------|------|
+| `services/serviceOrderService.uts` | ✅ 已修改：订单创建时填充经纬度 |
+| `pages/mall/consumer/payment.uvue` | ✅ 已修改：增加派单日志 |
+| `pages/mall/consumer/home-service/order-detail.uvue` | ✅ 已修改：增加派单日志 |
+| `pages/mall/consumer/orders.uvue` | ✅ 已修改：增加派单日志 |
+| `services/serviceOrderService.uts` | ✅ 已修改：区分显示5种失败原因 |
+| `mall_sql/diagnostics/dispatch_failure_diagnosis.sql` | 📋 诊断脚本（可选执行） |
+| `mall_sql/migrations/20260610_fix_service_order_coordinates.sql` | 🔧 修复历史订单经纬度 |
+| `mall_sql/migrations/20260610_optimize_dispatch_conflict_check.sql` | 🔧 优化版派单 RPC |
+
+## 后续优化建议
+
+1. **订单创建时设置预约时间范围**：将 `appointment_time` 转换为 `scheduled_start_at` 和 `scheduled_end_at`
+2. **服务人员位置实时更新**：确保 delivery 端定期上报当前位置
+3. **派单失败重试策略**：增加指数退避重试，避免频繁调用
+4. **监控告警**：当派单失败率超过阈值时发送告警