fix(pull): 订单查询 ErpState 过滤用单个等号,修抖店订单拉不到

用户抓包(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>
This commit is contained in:
liufumingren 2026-11-07 19:02:19 +08:00
parent 61a9587851
commit b22730fdcb
3 changed files with 89 additions and 10 deletions

View File

@ -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 过滤(实测有效,一次只回该商家的单)

View File

@ -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');
});
});

View File

@ -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` 标志,例如