From b22730fdcb17d29112909b03dfb0abdd054dd6df Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 7 Nov 2026 19:02:19 +0800 Subject: [PATCH] =?UTF-8?q?fix(pull):=20=E8=AE=A2=E5=8D=95=E6=9F=A5?= =?UTF-8?q?=E8=AF=A2=20ErpState=20=E8=BF=87=E6=BB=A4=E7=94=A8=E5=8D=95?= =?UTF-8?q?=E4=B8=AA=E7=AD=89=E5=8F=B7=EF=BC=8C=E4=BF=AE=E6=8A=96=E5=BA=97?= =?UTF-8?q?=E8=AE=A2=E5=8D=95=E6=8B=89=E4=B8=8D=E5=88=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户抓包(fxdd.dgjapp.com/NewOrder/List,dbname 空)返回 6 单抖店待发货, oms 拉取却是 0 单。逐个参数复刻后定位到 Filter 操作符写错: - 平台订单页发的是 `Filters[1][Contract]=%3D`(即单个 `=`) - OMS 发的是 `Contract: '=='`,抖店老分区(dzh93a8yur84Y3Yln2ha9RbPovVMhBTc) 直接回 `Success=false`「服务器繁忙,请稍会儿再试」 - 该错误被 `isFilterUnsupportedError` 当成「分区不支持过滤」→ 退化时间窗全量拉取 - 而平台**全量列表不返回待发货单**(实测 30 天 698/710 行全是 sended/success/close), 于是 6 单待发货怎么都拉不到,且被记成「拉取成功 0 单」 修复与验证: - `fetchOrderPage` 的 ErpState 过滤改为 `Contract: '='`(与浏览器一致); 实测三个分区均生效:抖店-186 → 6 单、精选平台四区 → 6 单、新系统区 → 0 单; `UpFxUserId` 的 `in` 过滤同样正常 - 修后 shop 19 一次拉单:18 单待处理(DYXD 12 / TB 4 / PDD 2), 其中 6 单 `875172835889885066` 等真抖店单已落 order_status_pending - 退化兜底分支补 warn:平台全量列表不含待发货单,命中兜底时要能看出可能漏单 - 单测 `dgjOrderQuery.test.js`:断言过滤条件为 `CreateTime:between | ErpState:= | UpFxUserId:in` - 文档更正 4.2.1 节:抓包是 `Contract=`,并记录本次踩坑与三分区对照表 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- backend/app/lib/printPlatform/dgj.js | 9 ++- backend/test/app/lib/dgjOrderQuery.test.js | 64 ++++++++++++++++++++++ 店管家取号-旧系统提取.md | 26 ++++++--- 3 files changed, 89 insertions(+), 10 deletions(-) create mode 100644 backend/test/app/lib/dgjOrderQuery.test.js diff --git a/backend/app/lib/printPlatform/dgj.js b/backend/app/lib/printPlatform/dgj.js index 5d3bc3a..076433d 100644 --- a/backend/app/lib/printPlatform/dgj.js +++ b/backend/app/lib/printPlatform/dgj.js @@ -1892,6 +1892,11 @@ class DgjService extends PrintPlatformService { start.getTime(), end.getTime() - Math.max(1, ORDER_FALLBACK_MAX_DAYS) * 24 * 3600 * 1000 )); + // 注意:平台「全量」列表不含待发货单,退化分支只能兜住已发货/已终结的核对, + // 拉待发货单必须靠「状态过滤」——所以这里留一条 warn,0 单时不会被误当成「平台没有单」 + if (this.logger && typeof this.logger.warn === 'function') { + this.logger.warn('[dgj] %s 的 %s 不支持状态过滤,退化为时间窗全量拉取(可能漏掉待发货单)', host, areaLabel); + } fetched = await this.fetchOrderPages(host, { traceId, dbname: area.dbname, @@ -2100,6 +2105,8 @@ class DgjService extends PrintPlatformService { }, ]; // 状态过滤:与平台「待发货订单」页同口径(ErpState == waitsellersend) + // ⚠️ Contract 必须是单个 `=`(浏览器抓包口径);写成 `==` 时抖店老分区会返回 + // 「服务器繁忙,请稍会儿再试」,导致 6 单待发货被当成「该分区不支持过滤」 if (erpState) { filters.push({ TableAlias: 'o', @@ -2107,7 +2114,7 @@ class DgjService extends PrintPlatformService { TableName: 'LogicOrder', Name: 'ErpState', Value: String(erpState), - Contract: '==', + Contract: '=', }); } // 商家过滤:平台按 PathFlowNode.UpFxUserId 过滤(实测有效,一次只回该商家的单) diff --git a/backend/test/app/lib/dgjOrderQuery.test.js b/backend/test/app/lib/dgjOrderQuery.test.js new file mode 100644 index 0000000..4ab88a5 --- /dev/null +++ b/backend/test/app/lib/dgjOrderQuery.test.js @@ -0,0 +1,64 @@ +'use strict'; + +const { assert } = require('egg-mock/bootstrap'); +const DgjService = require('../../../app/lib/printPlatform/dgj'); + +describe('lib/printPlatform/dgj 订单查询报文口径', () => { + /** + * 造一个只用于报文断言的服务实例 + * @return {Object} 店管家服务实例 + */ + function buildService() { + return new DgjService({ + platform: { code: 'dgj', name: '店管家', url: 'fxdd.dgjapp.com', fetch_waybill_no: 1 }, + account: { id: 1, account: 'tester', password: 'pwd', token: 'token', cookie: '' }, + }); + } + + it('ErpState 过滤的 Contract 必须是单个等号(写成 == 抖店老分区会回「服务器繁忙」)', async () => { + const service = buildService(); + let captured = null; + service.request = async (url, options) => { + captured = new URLSearchParams(options.body); + return { status: 200, json: { Success: true, Data: { Rows: [], Total: 0 } }, text: '', setCookies: [] }; + }; + + await service.fetchOrderPage('fxdd.dgjapp.com', { + traceId: 'trace', + dbname: 'dzh93a8yur84Y3Yln2ha9RbPovVMhBTc', + startTime: new Date('2026-10-09T00:00:00+08:00'), + endTime: new Date('2026-11-07T23:59:59+08:00'), + pageIndex: 1, + erpState: 'waitsellersend', + merchantFxUserId: '953516', + }); + + const contracts = []; + for (let index = 0; index < 5; index += 1) { + const name = captured.get(`Filters[${index}][Name]`); + if (!name) break; + contracts.push(`${name}:${captured.get(`Filters[${index}][Contract]`)}`); + } + console.log('过滤条件:', contracts.join(' | ')); + assert.deepStrictEqual(contracts, [ 'CreateTime:between', 'ErpState:=', 'UpFxUserId:in' ]); + }); + + it('不传状态时只带时间窗', async () => { + const service = buildService(); + let captured = null; + service.request = async (url, options) => { + captured = new URLSearchParams(options.body); + return { status: 200, json: { Success: true, Data: { Rows: [], Total: 0 } }, text: '', setCookies: [] }; + }; + await service.fetchOrderPage('fxali.dgjapp.com', { + traceId: 'trace', + dbname: '', + startTime: new Date('2026-11-01T00:00:00+08:00'), + endTime: new Date('2026-11-07T00:00:00+08:00'), + pageIndex: 1, + }); + assert.strictEqual(captured.get('Filters[1][Name]'), null); + assert.strictEqual(captured.get('Filters[0][Contract]'), 'between'); + assert.strictEqual(captured.get('PageSize'), '500'); + }); +}); diff --git a/店管家取号-旧系统提取.md b/店管家取号-旧系统提取.md index 3758ea5..198b26e 100644 --- a/店管家取号-旧系统提取.md +++ b/店管家取号-旧系统提取.md @@ -214,23 +214,31 @@ Filters[0] TableAlias=o FieldType=DateTime TableName=LogicOrder Name=CreateTi Filters[1] TableAlias=o FieldType=string TableName=LogicOrder Name=ErpState Value=waitsellersend Contract== ``` +> ⚠️ **上一行的 `Contract=` 只有一个等号**,抓包里是 `Filters[1][Contract]=%3D`(即 `=`)。 +> 2026-11-07 线上「抖音平台的订单拉取不到」就是这个符号写错导致的: +> OMS 早期按 `Contract: '=='` 发,抖店老分区直接回「服务器繁忙,请稍会儿再试」, +> 被误判成「该分区不支持过滤」→ 退化全量拉取 → 而平台**全量列表里不含待发货单**, +> 于是抖店 6 单待发货怎么都拉不到。改成 `=` 后同一分区立刻返回 6 单。 +> 单测见 `test/app/lib/dgjOrderQuery.test.js`(断言 `ErpState:=`)。 + 按商家(店铺)过滤时平台再加一个 Filter(值就是商家的 `FxUserId`,与 `shops.external_data.FxUserId` 一致): ``` Filters[2] TableAlias=pfn FieldType=int TableName=PathFlowNode Name=UpFxUserId Value=1327427 Contract=in ``` -⚠️ **分区差异(重要)**:这两个 Filter 只在**新系统区**(`dbname=y/2wUDWCZOk=`)生效; -老分区(如「精选平台四区」`wdJM8OZZiF4gKKxb82bFQlqydSPSQ9/W`、「抖店-186」`dzh93a8yur84Y3Yln2ha9RbPovVMhBTc`) -带 `ErpState`/`UpFxUserId` 会直接返回「服务器繁忙,请稍会儿再试」。 +实测(2026-11-07,账号 15197817068)三个分区都支持「待发货 + 商家」过滤: -因此 `DgjService.listOrders` 的策略是:新系统区带「待发货 + 商家」过滤(只拉本店待发货单), -老分区捕获「服务器繁忙」后退化为只按时间窗拉全量、再在本地按商家与状态过滤(`fallbackHosts` 会带回退化分区清单, -`externalPrintOrder` 会打 warn 日志)。老分区退化时窗口封顶 `DGJ_FALLBACK_MAX_DAYS`(默认 15 天), -避免「全部待处理」这类超大窗口在只能全量拉的分区上翻上百页。 +| 分区 | 仅状态过滤 | 状态 + 商家 in | 状态 + 商家 = | +|---|---|---|---| +| 抖店-186 `dzh93a8yur84Y3Yln2ha9RbPovVMhBTc` | 6 单 | 6 单 | 6 单 | +| 新系统区 `y/2wUDWCZOk=` | 0 单 | 0 单 | 0 单 | +| 精选平台四区 `wdJM8OZZiF4gKKxb82bFQlqydSPSQ9/W` | 6 单 | 6 单 | 6 单 | -分区的能力用进程内缓存 `AREA_FILTER_SUPPORT`(key = `host|dbname`,TTL 1 小时)记住, -这样同一个老分区每小时最多只白撞一次「服务器繁忙」,之后直接走全量兜底分支。 +⚠️ **退化兜底的真实局限**:一旦某个分区真的不支持过滤(或像上面那样写错操作符), +退化分支只按时间窗拉全量,而平台全量列表**不返回待发货单**,因此「0 单」并不代表没有待发货单。 +`DgjService.listOrders` 仍然保留退化分支(防老分区彻底不可用),但会打 warn; +`externalPrintOrder.buildZeroOrderHint` 会在 0 单时把「平台实际出现的商家」写进提示,便于判断。 **按商家分区声明决定要不要拉老分区**:商家列表接口 `POST /Partner/LoadMyAgentList` 返回的 `DbAreas[]`(已整体存在 `shops.external_data`)每一项带 `IsNewSystem` 标志,例如