Kaynağa Gözat

docs(乐收赢): 订正 LsyOrderService 里那句被证伪的 H5 关单注释

91280dd 改了 LsyCancelService(H5 关单改打上游 /v3/closeorder)并把那里的注释订正了,
但**同一个假前提在另一个文件里还有一份**,这次漏掉了:LsyOrderService.createH5Order 的
javadoc 收尾写着「上游『H5支付』目录下无独立关单接口,本类不为 H5 提供关单路径(见 spec §2.3)」。

两句要分开判:
  * 「本类不为 H5 提供关单路径」—— 仍然成立(关单在 LsyCancelService,不在这里)。
  * 「上游 H5 目录下无独立关单接口」—— **字面仍真**:142 页文档里标题含「关单」的只有三页
    (196236529 /v3/closeorder、196236547 /v3/qrclose、196236550 云订单 /v3/trade/closePayTrade),
    H5 目录下确实一页都没有。
  但由它推出的「所以 H5 关不了单」是**假的** —— /v3/closeorder 落在「支付接口」目录下,
  正文只写了可供「二维码支付、JSAPI支付」,实测对 H5 一样受理。取证是差分对照:
  同刻两笔同参 H5,只关 A ⇒ A 由 PAY_IN_PROCESS 变 PAY_FAIL,没动的 B 仍是 PAY_IN_PROCESS
  (logs/_lsy-close-control.txt)。

为什么必须改:这是一句**会被下一个读代码的人当成设计决定**的话 —— 照着它去推断,
就会重新得出「H5 只能本地收敛,上游那条支付链接还活着也没关系」这个已经被证伪的结论,
而那个结论的代价是钱收了、单是「已过期」。留着它,等于把那个坑重新挖开。

纯注释改动(+9/-1,git diff 里没有一行非注释),静息行为零变化。
LsyH5PayTest 6 / 0 / 0 / 0 绿。
alphaH 2 hafta önce
ebeveyn
işleme
282b1201e3

+ 9 - 1
java/src/main/java/com/payment/platform/module/payment/leshouying/service/LsyOrderService.java

@@ -331,7 +331,15 @@ public class LsyOrderService {
      *   2. 会返回 PAY_IN_PROCESS
      *   3. 但用户会被跳转到支付 App,停留时长不可控 → 不做同步轮询
      *
-     * 上游「H5支付」目录下无独立关单接口,本类不为 H5 提供关单路径(见 spec §2.3)。
+     * 【与关单的关系 —— 2026-09-28 订正,原句是「上游『H5支付』目录下无独立关单接口,
+     *  本类不为 H5 提供关单路径」】关单确实**不在本类**(这一半仍然成立),它在
+     *  {@code LsyCancelService#closeH5Order};但原句的前半句**字面仍真、推出的结论是假的**:
+     *  142 页文档里标题含「关单」的只有三页,H5 目录下确实一页都没有 ——
+     *  但 {@code /v3/closeorder} 落在「支付接口」目录下,正文只写了可供「二维码支付、JSAPI支付」,
+     *  <b>实测对 H5 一样受理</b>(差分对照:同刻两笔同参 H5,只关 A ⇒ A 由
+     *  {@code PAY_IN_PROCESS} 变 {@code PAY_FAIL},没动的 B 仍是 {@code PAY_IN_PROCESS};
+     *  读数见 {@code LsyCancelService#closeH5Order} 的 javadoc 与 {@code logs/_lsy-close-control.txt})。
+     *  ⇒ 别照这句去推断「H5 关不了单」。
      */
     public LsyPayResultDTO createH5Order(LsyOrderEntity order, String payType) {
         LsyPayType type = LsyPayType.ofRequired(payType);   // AUTO 会被拒绝