From 28e4b98975c93ccb93ea4232140f6772d9aa584c Mon Sep 17 00:00:00 2001 From: lml <1297555865@qq.com> Date: Tue, 17 Nov 2026 17:20:40 +0800 Subject: [PATCH] =?UTF-8?q?test(hengjian):=20=E5=9C=B0=E5=9D=80=E8=AF=86?= =?UTF-8?q?=E5=88=AB=E6=94=B9=E7=94=A8=E5=B7=B2=E7=9F=A5=E7=AD=94=E6=A1=88?= =?UTF-8?q?=E7=9A=84=E5=9C=B0=E5=9D=80=E5=81=9A=E6=AD=A3=E4=BE=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 上一轮用普通地址测出 UNKNOWN 时无法判断是接口问题还是地址库覆盖问题。 换成两个已知答案的地址验证: Google HQ (1600 Amphitheatre Pkwy, Mountain View, CA 94043) = BUSINESS Apple HQ (1 Infinite Loop, Cupertino, CA 95014) = BUSINESS 结论:接口与映射都正常,「UNKNOWN」是恒健地址库没覆盖到该地址, 不是 bug。探针保留一个 UNKNOWN 样例并注明原因,避免下次误判。 另外确认 country 必须是两字母 ISO 码,给 USA 回 400。 同时修正计费接口的故障描述:不是某一个接口挂,三个 (仓储费 / 尾程费 / 作业费)都会间歇性回 Elasticsearch scroll 异常, 同参数重试有时成功。 --- docs-warehouse/hengjian/README.md | 17 +++++++++++++---- .../hengjian/probe/HengjianReadOnlyProbeTest.java | 17 ++++++++++++++--- 2 files changed, 27 insertions(+), 7 deletions(-) diff --git a/docs-warehouse/hengjian/README.md b/docs-warehouse/hengjian/README.md index 5e1a8f1..28b2e76 100644 --- a/docs-warehouse/hengjian/README.md +++ b/docs-warehouse/hengjian/README.md @@ -1110,7 +1110,7 @@ mvn -pl warehouse-sdk-hengjian -DfailIfNoTests=false \ | `POST /v1/saleReturn/thirdParty/getReturnPlanOrderPage` / `getReturnPlanOrderInfo` | 正常 | | `POST /v1/saleReturn/getReturnPlanHandlePage` | 正常,页码 0 基 | | `POST /v2/api/shipping/calculate` | 正常(需发运仓) | -| `POST /v2/api/shipping/addressClassification` | 路径通,但该地址回 `UNKNOWN` | +| `POST /v2/api/shipping/addressClassification` | 正常。Google / Apple 总部 → **BUSINESS**;仓方库覆盖不到的地址 → `UNKNOWN` | ### 真机纠正的错误 @@ -1126,9 +1126,18 @@ mvn -pl warehouse-sdk-hengjian -DfailIfNoTests=false \ ### 仓方自身故障(非我方问题) -`POST /v1/chargingSettlement/getChargingStorageSettlement` 在测试环境回 -`code=999999` + Elasticsearch scroll 异常(`charging_storage_settlements` 索引)。 -**这是恒健侧 ES 故障**,我方报文正确。 +三个计费接口在测试环境间歇性回 `code=999999`: + +``` +获取账单执行明细失败:org.springframework.data.elasticsearch.ElasticsearchException: +Error for search request with scroll ... indices=[charging_storage_settlements] +``` + +从异常里的 DSL 能看到我方报文正确(`orgWarehouseCode:["EFCA"]`、 +`chargeAt` 区间、`disabledAt:0` 都对)。**是恒健侧 ES 索引故障**, +同一参数重试有时成功(返回 0 条)。 + +三个接口(仓储费 / 尾程费 / 作业费)都会中招,不是某一个的问题。 ### 未覆盖 diff --git a/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/probe/HengjianReadOnlyProbeTest.java b/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/probe/HengjianReadOnlyProbeTest.java index e517abc..f2afff2 100644 --- a/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/probe/HengjianReadOnlyProbeTest.java +++ b/warehouse-sdk-hengjian/src/test/java/common/ecommerce/hengjian/probe/HengjianReadOnlyProbeTest.java @@ -655,7 +655,12 @@ class HengjianReadOnlyProbeTest { /** * 地址属性识别:只读,判定商业 / 住宅。 * - *
真机确认五项必填(street1 / city / state / postal / country)。
+ *真机确认五项必填(street1 / city / state / postal / country)—— + * {@code country} 必须是两字母 ISO 码,给 {@code USA} 会回 400。
+ * + *用两个已知答案的地址做正例:Google / Apple 总部都是 BUSINESS。 + * 注意恒健的地址库覆盖不全(一些真实地址会回 UNKNOWN),所以 + * UNKNOWN 不代表接口有问题。
*/ @Test void probeAddressClassification() { @@ -663,9 +668,15 @@ class HengjianReadOnlyProbeTest { run("POST /v2/api/shipping/addressClassification", new Runnable() { @Override public void run() { - AddressType type = adapter().classifyAddress(ctx(), + AddressType google = adapter().classifyAddress(ctx(), + "1600 Amphitheatre Pkwy", null, "Mountain View", "CA", "94043", "US"); + System.out.println(" Google HQ = " + google); + AddressType apple = adapter().classifyAddress(ctx(), + "1 Infinite Loop", null, "Cupertino", "CA", "95014", "US"); + System.out.println(" Apple HQ = " + apple); + AddressType unknown = adapter().classifyAddress(ctx(), "351 S Waterman Ave", null, "San Bernardino", "CA", "92408", "US"); - System.out.println(" 地址属性=" + type); + System.out.println(" 普通地址 = " + unknown + "(仓方库覆盖不到时回 UNKNOWN)"); } }); }