From 0da93008d0a7cc4f68f81630cad76bcc3b52e810 Mon Sep 17 00:00:00 2001
From: WorkBuddy <workbuddy@local>
Date: Sat, 19 Sep 2026 11:43:13 +0800
Subject: [PATCH] =?UTF-8?q?test(miniapp):=20=E8=A1=8C=E4=B8=BA=E5=A5=91?=
 =?UTF-8?q?=E7=BA=A6=E7=9A=84=E6=A1=A9=E6=94=B9=E4=B8=BA=E5=BF=A0=E5=AE=9E?=
 =?UTF-8?q?=E6=A8=A1=E6=8B=9F=20wx=20=E5=9B=9E=E8=B0=83=E5=8C=85=E8=A3=85?=
 =?UTF-8?q?=EF=BC=88=E5=BC=82=E5=B8=B8=E4=B8=8D=E5=A4=96=E9=80=B8=EF=BC=8C?=
 =?UTF-8?q?=E8=BD=AC=20App.onError=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

原桩直接同步调用 `opt.success(...)`，被测代码在回调内抛错时异常会**外逸到测试进程**，
于是「请求永不 settle」这一真实后果反而测不出来 —— 报出来的是注入的异常本身，
而不是「Promise 永久 pending」。

真实小程序里 `wx.request` 的回调是被 wx 包装的：回调内抛错**不会**打断请求链，
而是被捕获后走 `App.onError`（本轮控制台实测 `[App onError] MiniProgramError`），
后果是 `resolve` 永不执行。桩必须保真这一点，否则判据会在错误的地方变红。

改动：
- `respond()` 捕获回调内异常并记录，不外逸；
- 成功路径新增断言：成功回调内**不得**抛出任何异常（附明确失败信息）。

负向自证（改前已实测）：在 `resolve(body.data)` 之前注入一行抛错 →
本契约输出 `Promise 在 1000ms 内未 settle —— 收尾逻辑又跑到了 resolve 之前` 并退出 1；
移除注入后 `git diff --exit-code` 为空（逐字节还原），全量门禁 **18/18 PASS**。
---
 ui-tests/miniapp-api-client-behavior.mjs | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/ui-tests/miniapp-api-client-behavior.mjs b/ui-tests/miniapp-api-client-behavior.mjs
index b4b684f..f8e91c7 100644
--- a/ui-tests/miniapp-api-client-behavior.mjs
+++ b/ui-tests/miniapp-api-client-behavior.mjs
@@ -37,11 +37,22 @@ globalThis.wx = {
 
 const api = require(resolve(root, 'miniapp/utils/api.js'))
 
+/**
+ * 模拟 wx 的回调包装：回调内抛出的异常**不会外逸**，而是被 wx 捕获后走 `App.onError`
+ * （本机控制台实测即如此：`[App onError] MiniProgramError ...`）。
+ * 保真这一点很关键 —— 否则桩会把异常直接抛给测试进程，
+ * 于是"请求永不 settle"这一真实后果反而测不出来。
+ */
+const callbackErrors = []
 function respond(statusCode, data) {
   assert.ok(pendingRequest, '没有待响应的请求 —— 被测代码没走到 wx.request')
   const opt = pendingRequest
   pendingRequest = null
-  opt.success({ statusCode, data })
+  try {
+    opt.success({ statusCode, data })
+  } catch (error) {
+    callbackErrors.push(error)
+  }
 }
 
 /** 断言 Promise 在限定时间内 settle，否则视为「永不 settle」缺陷 */
@@ -69,6 +80,13 @@ function withinSettle(promise, ms = 1000) {
     key,
     '幂等键必须真的写进请求头（否则后端无法识别重复投递）',
   )
+  // 成功回调内**不得**抛出任何异常：一旦抛出，wx 会捕获后转 App.onError，
+  // 而 `resolve` 已经不会执行 → 该请求的 Promise 永久 pending（页面卡 loading）。
+  assert.deepEqual(
+    callbackErrors.map((e) => `${e && e.name}: ${e && e.message}`),
+    [],
+    '成功回调内抛出了异常 —— 在真实小程序里会表现为该请求永不 settle（页面卡 loading）',
+  )
 }
 
 // ── 2. 成功之后必须释放幂等键：同域下一次操作应拿到**新**键 ──