From e22dcf2eada9948658e4dc0b2cbdf79d5e1df49f Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 7 Nov 2026 22:56:20 +0800 Subject: [PATCH] =?UTF-8?q?fix(send):=20=E9=80=90=E5=8D=95=E5=BD=A2?= =?UTF-8?q?=E6=80=81=E7=9A=84=E3=80=8C=E5=AD=98=E5=9C=A8=E4=B8=8D=E6=98=AF?= =?UTF-8?q?=E5=BE=85=E5=8F=91=E8=B4=A7=E7=9A=84=E5=95=86=E5=93=81=E3=80=8D?= =?UTF-8?q?=E4=B9=9F=E6=8C=89=E5=B7=B2=E5=90=8C=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 上一版只覆盖了整包 `Success:false + Message` 的形态,线上这条提示其实走的是**逐单**分支: `{"Success":true,"Data":{"Orders":[{"IsSuccess":false,"ErrorMessage":"存在不是待发货的商品,发货失败;"}]}}`, 而逐单幂等正则要求「不是待发货状态」,少了「状态」两字没命中,于是照旧抛错重试。 用户看到的 `店管家发货同步失败:: 存在不是待发货…` 里的双冒号就是逐单分支 + 平台未回 LogicOrderId 造成的。 - 抽出 SEND_ALREADY_DONE_PATTERN(不是待发货 / 已发货 / 已取消 / 已关闭),整包与逐单共用 - 逐单失败且平台未回 LogicOrderId 时不再拼「: 」前缀,避免出现「失败:: xxx」 - 单测补 2 例(逐单幂等 / 无单号时不出现双冒号),共 5 例 - 文档补两种形态的报文明细 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- backend/app/lib/printPlatform/dgj.js | 24 ++++++++++----- .../test/app/lib/dgjSendIdempotent.test.js | 30 +++++++++++++++++++ 店管家取号-旧系统提取.md | 12 +++++++- 3 files changed, 58 insertions(+), 8 deletions(-) diff --git a/backend/app/lib/printPlatform/dgj.js b/backend/app/lib/printPlatform/dgj.js index f1a9abf..145f04a 100644 --- a/backend/app/lib/printPlatform/dgj.js +++ b/backend/app/lib/printPlatform/dgj.js @@ -137,6 +137,15 @@ function isRateLimited(json) { return /isv\.request-limited|请求太频繁|访问QPS|限流/i.test(text); } +/** + * 「这一单平台侧已不是待发货」类提示:已发货/已取消/已关闭都算,属幂等(本地按已同步处理) + * + * 实测两种形态:整包 `{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}` + * 与逐单 `Data.Orders[] IsSuccess=false + ErrorMessage="存在不是待发货的商品,发货失败;"` + * (后者 `LogicOrderId` 常为空,拼接出来就是「店管家发货同步失败:: 存在不是待发货的商品…」)。 + */ +const SEND_ALREADY_DONE_PATTERN = /不是待发货|已发货|已取消|已关闭/; + /** * 提取发货回传的逐单失败(平台是「整包 Success + Data.Orders[] 逐单结果」) * @param {Object} json 平台响应 @@ -3114,7 +3123,7 @@ class DgjService extends PrintPlatformService { // 单包裹发送时,平台整包回「存在不是待发货的商品,发货失败」= 这一单已经不在待发货 // (平台侧已发货/已取消),属于幂等:直接按成功返回,避免反复重试被打成「异常」 const topMessage = String((res.json && res.json.Message) || ''); - if (res.json && res.json.Success !== true && orders.length === 1 && /不是待发货|已发货|已取消|已关闭/.test(topMessage)) { + if (res.json && res.json.Success !== true && orders.length === 1 && SEND_ALREADY_DONE_PATTERN.test(topMessage)) { if (this.logger && typeof this.logger.info === 'function') { this.logger.info('[dgj.sendOrders] 平台侧该单已不是待发货,按已同步处理:%s %s', orders[0].LogicOrderId, topMessage); } @@ -3149,9 +3158,9 @@ class DgjService extends PrintPlatformService { } // 平台是「整包 Success + 逐单结果」:逐单失败要单独判,否则会把没发成功的单标成已同步。 - // 例外:单子已经是已发货状态(平台早于我们手工/别处发货)视为幂等成功。 + // 例外:单子已经是已发货/已取消状态(平台早于我们手工/别处发货)视为幂等成功。 const failed = extractSendOrderFailures(res.json); - const realFailures = failed.filter(item => !/不是待发货状态|已发货|已取消|已关闭/.test(item.message)); + const realFailures = failed.filter(item => !SEND_ALREADY_DONE_PATTERN.test(item.message)); if (realFailures.length) { // 风控/渠道不匹配:平台按「模板对应的电子面单渠道」校验运单号,模板与运单快递不一致就会拦截 const riskBlocked = realFailures.some(item => @@ -3159,10 +3168,11 @@ class DgjService extends PrintPlatformService { const hint = riskBlocked ? '(运单号不是该平台渠道分配的面单:请确认发货模板与运单快递一致,并用「对应平台 + 该快递」的电子面单模板重新取号)' : ''; - throw buildPlatformError( - `店管家发货同步失败:${realFailures.map(item => `${item.logicOrderId}: ${item.message}`).join(';')}${hint}`, - res - ); + // 平台有时不回 LogicOrderId,此时不要拼出「失败:: xxx」这种双冒号 + const detail = realFailures + .map(item => (item.logicOrderId ? `${item.logicOrderId}: ${item.message}` : item.message)) + .join(';'); + throw buildPlatformError(`店管家发货同步失败:${detail}${hint}`, res); } if (failed.length && this.logger && typeof this.logger.info === 'function') { for (const item of failed) { diff --git a/backend/test/app/lib/dgjSendIdempotent.test.js b/backend/test/app/lib/dgjSendIdempotent.test.js index 3063479..c877217 100644 --- a/backend/test/app/lib/dgjSendIdempotent.test.js +++ b/backend/test/app/lib/dgjSendIdempotent.test.js @@ -76,4 +76,34 @@ describe('dgj.sendOrders 幂等口径', () => { /店管家发货同步失败:12;ErrorCode=500/ ); }); + + it('逐单回「存在不是待发货的商品」也按已同步处理(LogicOrderId 为空)', async () => { + const service = stubResponse(buildService(), { + Success: true, + ErrorCode: '200', + Data: { Orders: [{ IsSuccess: false, ErrorMessage: '存在不是待发货的商品,发货失败;' }] }, + }); + const out = await service.sendOrders('fxdd.dgjapp.com', { + traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA', + }); + assert.strictEqual(out.Success, true); + }); + + it('逐单真失败时错误里的单号前缀不会出现「::」', async () => { + const service = stubResponse(buildService(), { + Success: true, + ErrorCode: '200', + Data: { Orders: [{ IsSuccess: false, ErrorMessage: '运单号已被使用' }] }, + }); + await assert.rejects( + () => service.sendOrders('fxdd.dgjapp.com', { + traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA', + }), + err => { + assert.match(err.message, /店管家发货同步失败:运单号已被使用/); + assert.doesNotMatch(err.message, /::/); + return true; + } + ); + }); }); diff --git a/店管家取号-旧系统提取.md b/店管家取号-旧系统提取.md index 2f1ee50..08791f4 100644 --- a/店管家取号-旧系统提取.md +++ b/店管家取号-旧系统提取.md @@ -75,12 +75,22 @@ Orders[0][Sender][SenderCompany/CompanyName] / [ReceiverIsEmpty]=0 / [PrintInfo] "ErrorMessage":"订单不是待发货状态,请检查"}]}} ``` -OMS 口径:逐单 `IsSuccess=false` 时,除「不是待发货状态 / 已发货 / 已取消 / 已关闭」(幂等,视为已同步)外都算失败。 +OMS 口径:逐单 `IsSuccess=false` 时,除「不是待发货 / 已发货 / 已取消 / 已关闭」(幂等,视为已同步)外都算失败。 整包层面也有一种幂等:单包裹发送时若平台整包回 `{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}`,说明这一单平台侧已不在待发货 (已发货/已取消),同样**按已同步处理**(`dgj.sendOrders` 直接返回,不发异常),否则会被重试 3 次打成「同步异常」。 +⚠️ 这条提示**两种形态都出现过**(口径统一用 `SEND_ALREADY_DONE_PATTERN` 判): + +| 形态 | 报文 | +|---|---| +| 整包失败 | `{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}` | +| 逐单失败 | `{"Success":true,"Data":{"Orders":[{"IsSuccess":false,"ErrorMessage":"存在不是待发货的商品,发货失败;"}]}}` | + +逐单形态平台常不回 `LogicOrderId`,旧实现会拼成 `店管家发货同步失败:: 存在不是待发货的商品…`(注意双冒号)—— +看到这种双冒号就是走到了逐单分支。现在逐单失败且无单号时不再拼前缀。 + OMS 实现: | 位置 | 作用 |