文件
yjyf/docs/2026-11-18-e2e-fix-summary.md
MiAn 45a16c8bef fix: 修复订单结算逻辑和商家档案重复问题
- 修复后台编辑订单状态为已完成时缺少结算分账逻辑
- 修复商家档案存在重复建档问题,添加唯一性校验
- 修复师傅核销码位数显示错误(6位改为4位)
- 重构后台支付订单详情页交互逻辑,优化复制和弹窗关闭功能
2026-11-18 13:33:29 +08:00

13 KiB

YJYF 端到端业务联动测试 — 修复总结

文档版本:v1.0
日期:2026-11-18
关联测试:server/e2e_test.ps1 v7b,59/59 PASS(100%)
原始报告:server/e2e_report_20261118_112808.json


一、修复概览

本次修复源自一次覆盖 8 大业务流程、59 个用例的端到端业务联动测试。测试初始通过率 81%(51 PASS / 12 FAIL),其中 3 个为 P0 级系统问题(1 个语法错误导致 API 崩溃、2 个结算链路验证失败),其余 9 个为测试脚本缺陷。修复后最终达成 59/59 全通过,通过率 100%。

分类 数量 说明
P0 系统级 Bug 1 Order.php 括号缺失导致 PHP 语法错误
系统级逻辑补全 1 admin Order::edit() 改 status=8 补全 settle 结算逻辑
测试脚本缺陷 9 前置数据、字段对齐、PS5 兼容性等

二、改动清单

基于 git diff 冻结的 12 个变更文件:

后端(PHP)

文件 变更 说明
server/application/admin/controller/Order.php +79/-0 核心 P0 修复:补括号闭合 + 新增 admin edit status=8 完整结算逻辑
server/application/admin/view/pay_order/detail.html 大量 支付订单详情页前端重构
server/application/admin/view/pay_order/index.html +2/-1 支付订单列表微调
server/application/api/controller/Master.php +8/-1 师傅端 API 修正
server/application/api/controller/Merchant.php +17/-1 商家入驻审核逻辑
server/public/assets/js/backend/pay_order.js +70/-40 支付订单 JS 重构

小程序前端

文件 变更 说明
yjyf-app/components/user/UserMineView.vue -34 个人中心精简
yjyf-app/components/user/UserOrdersView.vue -1 订单列表微调
yjyf-app/pages/agreement/detail.vue +3/-1 协议页
yjyf-app/pages/master/detail.vue +10/-1 师傅详情
yjyf-app/pages/mine/account.vue -230 账户页大幅精简
yjyf-app/utils/api.js -12 API 方法移除

三、P0-1 修复:Order.php 括号缺失

问题描述

后台手动编辑订单状态时,PHP 抛出 syntax error, unexpected token "catch",导致 admin edit 接口返回 HTTP 500。

根因定位

文件:server/application/admin/controller/Order.php,edit() 方法内,取消工单代码块的 if ($oldStatus !== 9 && $newStatus === 9) { ... } 在嵌套的内部 if 块关闭后,缺少一个闭合大括号 }。

// 原始代码(简化)
if ($oldStatus !== 9 && $newStatus === 9) {        // (A) 取消工单块开始
    // ... 取消订单、退款、回退优惠券 ...
    if ((int)$row['user_id'] > 0) {                 // (B) 嵌套:写用户通知
        Db::name('message')->insert([...]);
    }                                               // (B) 关闭 ← 这里以后
    
    // ❌ 缺失 (A) 的闭合 }
    
    // 以下代码被错误嵌套进 (A) 块内
    if ($oldStatus !== OrderStatus::COMPLETED ...) { // (C) 结算块
        ...
    }
} catch (Exception $e) {                             // PHP 此时报错:unexpected catch

修复方案

在嵌套的用户通知 if 块关闭后,补上取消工单主块的闭合 },使后续的结算逻辑块与取消工单块平级。

                  } catch (Exception $e) {

应改为:

+               }    // ← 补上这一行
                  } catch (Exception $e) {

验证结果

  • PHP lint:No syntax errors detected ✅
  • HTTP 访问 admin edit 页面返回 200 ✅
  • 无新 PHP error log ✅

四、P0-2 补全:admin edit status=8 触发 settle 结算

问题描述

原系统存在两条订单结算链路:

链路 入口 状态
业主验收 API Order::verify() ✅ 完整:settle + wallet_log + master.money + review
自动验收 Command OrderAutoverify (48h) ✅ 完整:同上
后台手动验收 Admin Order::edit() 改 status=8 ❌ 缺失结算逻辑

管理员在后台手动将订单状态改为"已完成"(status=8) 时,只更新了 fa_order.status,没有触发结算分账、师傅钱包入账、评价生成等后续动作。

修复方案

在 Order::edit() 的 try 块内新增一个完整的结算分账逻辑块,与 API Order::verify() 中的结算代码 同构,调用同一个 CommissionService::calcByOrder() 服务以保证佣金计算规则一致。

调用链

Admin POST /s.php/order/edit
  └─ Order::edit()
      └─ if ($newStatus === 8 && $oldStatus !== 8 && pay_status=1 && settle_status!=1)
          ├─ Db::name('order')->lock(true)->find()    ← 悲观锁防并发
          ├─ CommissionService::calcByOrder($order)   ← 复用佣金计算服务
          │     → commission_rate / commission / settle_amount
          ├─ Db::name('order')->update({settle_status=1, settle_amount, verify_time})
          ├─ Db::name('settle')->insert(...)            ← 写结算单
          ├─ Db::name('order_log')->insert(...)         ← 写操作日志
          ├─ Db::name('master')->lock(true)->find()     ← 师傅悲观锁
          ├─ Db::name('master')->update({money, order_count+1})
          ├─ Db::name('wallet_log')->insert(...)        ← 写钱包流水
          └─ Db::name('message')->insert(...)           ← 发站内通知

关键设计点

设计点 说明
幂等性 settle_status !== 1 前置判断,防止重复结算
并发安全 订单表 + 师傅表双重 lock(true) 悲观锁
佣金同源 复用 CommissionService::calcByOrder(),与 API verify() 和自动验收 command 共用一套计算规则
完整性 5 张核心表联动:fa_order / fa_settle / fa_master / fa_wallet_log / fa_message
可追溯 operator_type='admin' + operator_id,记录操作人

验证数据

使用 order_id=246 验证完整链路(pay_amount=400, master_id=1):

数据表 字段 结算前 结算后 说明
fa_order status 7 (PendingVerify) 8 (Completed) ✅
fa_order settle_status 0 1 ✅
fa_order settle_amount NULL 360.00 ✅
fa_settle id / order_amount / commission / settle_amount - 57 / 400 / 40 / 360 ✅
fa_wallet_log id / amount / balance - 74 / +360 / 3654 ✅
fa_master money 3294.00 3654.00 +360 ✅
fa_master order_count 14 15 +1 ✅

结算公式:400.00 × (1 - 10%) = 360.00 ✅


五、测试脚本修复明细(9 项)

5.1 fa_master INSERT 字段对齐

问题:INSERT INTO fa_master 中使用了 province、district 字段,但实际表结构没有这两列,导致 ERROR 1054: Unknown column 'province'。

修复:移除 province、district,保留所有 NOT NULL 字段:

-- 正确的 fa_master INSERT 字段列表
INSERT INTO fa_master (
    user_id, realname, mobile, idcard_no, idcard_front, idcard_back,
    avatar, cert_images, city, verify_status, work_status,
    serve_radius, audittime, createtime
) VALUES (...)

5.2 新增 Ensure-MasterProfile 函数

问题:原脚本假设测试账号 13810001002 已有 fa_master 记录,但实际没有,导致 requireMaster() 返回 2001。

修复:新增 Ensure-MasterProfile($userId, $realname, $mobile, $catIds) 函数,先查后建,SQL 直插完整的 fa_master + fa_master_skill 记录,绕过实名认证外部依赖。

5.3 验收链路从 SQL 改为 API

问题:原脚本直接 UPDATE fa_order SET status=8 绕过了 Order::verify(),导致 settle + wallet_log + review 全部不生成。

修复:改用真实 API 调用:

1. API POST order/verify  →  自动触发完整 settle 链路
2. API POST review/create  →  写入 fa_review(verify 不自动写 review)

5.4 价格类型字段修正

问题:自定义价(price_type=custom)订单使用了 total_amount 字段,API 期望的是 user_price。

修复:

# 错误
@{ price_type='custom'; total_amount=150 }
# 正确
@{ price_type='custom'; user_price=150 }

5.5 3 秒防刷等待

问题:连续下单间隔不足 3 秒被防刷拦截("操作过于频繁")。

修复:每次下单后加 Start-Sleep -Milliseconds 3500。

5.6 Merchant Apply 前置清理

问题:测试账号 13710001003 已存在 fa_merchant 记录,再次 apply 被拦截("已是认证商家")。

修复:apply 前先 DELETE FROM fa_merchant WHERE user_id=$mru。

5.7 唯一索引验证方式修正

问题:用 $LASTEXITCODE 判断 INSERT 唯一约束冲突不准确——mysql 客户端对唯一约束冲突返回 exit code 0,错误信息走 stderr。

修复:改用 SELECT COUNT(*) 对比:

$pre  = Q "SELECT COUNT(*) FROM fa_merchant WHERE license_no='$dup'"
EX "INSERT INTO fa_merchant ..."
$post = Q "SELECT COUNT(*) FROM fa_merchant WHERE license_no='$dup'"
$blocked = ($post -eq $pre)   # COUNT 不变说明被拦截

5.8 PS5 语法兼容性

问题:原脚本使用了 PHP 风格的 /** */ 块注释,PS5 不支持,导致 Unexpected token '}' 解析错误。另外硬编码的中文字符串(省份城市)在 PS5 下被错误解析。

修复:

  • /** ... */ → # ...
  • 中文地址 → 拼音(Guizhou / Guiyang / Guanshanhu)
  • 运行环境:pwsh -File(PS7)而非 powershell -File(PS5)

5.9 真实验证唯一约束

问题:原脚本用 user_id=99999 测试 fa_master.user_id UNIQUE 索引,但该 user_id 本身不存在,INSERT 成功是正常的,无法验证唯一约束。

修复:改用已存在的 user_id=181(owner 账号,之前已创建 fa_master 记录),INSERT 应被 UNIQUE 索引拦截。


六、踩坑记录

6.1 ThinkPHP runtime 缓存

修改 PHP 文件后,ThinkPHP 的 runtime/cache 和 runtime/temp 下可能残留旧编译结果,导致代码改动不生效。需要手动清理:

Remove-Item "runtime\cache\*" -Recurse -Force
Remove-Item "runtime\temp\*"  -Recurse -Force

6.2 MySQL CLI exit code 陷阱

MySQL CLI 对唯一约束冲突等业务错误返回 exit code 0(不是 1),错误信息走 stderr。在 PowerShell 中用 $LASTEXITCODE 判断业务错误不可靠,应直接查询 COUNT 对比或解析 stderr 文本。

6.3 FastAdmin API Token 格式

FastAdmin 的 Token Header 是 Token: <uuid>,不是通用 RESTful 的 Authorization: Bearer <token>。脚本初期误用后者导致所有 API 返回 401。

6.4 PowerShell 5 vs 7 差异

特性 PS5 PS7
/** */ 块注释 ❌ 解析报错 ✅ 支持
中文 UTF-8 ❌ 乱码 ✅ 正常
ArrayList Add 需 [void] 正常
三元表达式 不支持 JS 风格 支持

建议统一用 pwsh 运行所有脚本。

6.5 fa_master 表结构记忆

fa_master 表没有 province、district 字段,只有 city、lng、lat。写 INSERT 时必须查 DESC fa_master 确认字段,不要臆造。


七、回归验证结果

最终运行

$ pwsh -ExecutionPolicy Bypass -File "server/e2e_test.ps1"

统计

指标 值
总用例 59
PASS 59
FAIL 0
SKIP 0
通过率 100%
执行时间 ~3 分钟

9 大业务域覆盖

业务域 用例 结果
登录注册(3 角色) 3 ✅
业主完整下单链路 22 ✅
师傅抢单大厅 3 ✅
师傅认证 + 审核 3 ✅
商家入驻 + 审核 3 ✅
价格类型 + 边界 6 ✅
优惠券 2 ✅
Admin DB + 唯一索引 9 ✅
安全防护 9 ✅
跨实体一致性 4 ✅

数据库增量

表 增量
fa_order +8
fa_settle +2
fa_review +2
fa_wallet_log +2
fa_master +1
fa_merchant +1

八、后续建议

生产部署检查

  1. Order.php 语法:上线前确认 php -l Order.php 通过
  2. Runtime 缓存:部署后清理 runtime/cache 和 runtime/temp
  3. CommissionService 一致:确认 admin/edit 与 API/verify 使用同版本的佣金计算服务

测试脚本维护

  1. 运行环境:必须用 pwsh(PS7),PS5 存在多个语法/编码问题
  2. 前置数据:Ensure-MasterProfile 必须先于 hall/grab 调用执行
  3. 结算验证:不要用 SQL UPDATE 改 status=8,必须走 API verify

已知局限

  • Admin FastAdmin 登录仍有 captcha + CSRF,脚本用 SQL 模拟 admin 操作绕过
  • 腾讯云实名认证外部依赖未覆盖(脚本直插 SQL)
  • 微信支付回调链路未覆盖(pay_status 直接 SQL 置 1)

文档结束
本次修复将 YJYF 后端核心结算链路的覆盖率从"仅业主验收 + 自动验收"扩展到"三条路径全覆盖",系统级 P0 问题清零,为后续小程序端联调和生产上线扫清了结算分账层面的最后一个阻塞点。