From 98330ca87c3d4d00449a7cf9e8e8c8280835681e Mon Sep 17 00:00:00 2001
From: lml <1297555865@qq.com>
Date: Thu, 5 Nov 2026 14:59:51 +0800
Subject: [PATCH] =?UTF-8?q?test(observability):=20=E8=A6=86=E7=9B=96?=
=?UTF-8?q?=E9=97=A8=E9=9D=A2=E6=97=A5=E5=BF=97=E4=B8=8E=E9=A2=86=E6=98=9F?=
=?UTF-8?q?=E8=B0=83=E7=94=A8=E9=93=BE=E8=B7=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- 新增 CallObserverTest:成功/失败记录、观察者异常隔离、默认 NOOP、UTC 与本地时间转换
- 新增 LingxingCallObserverTest:用 RecordingTransport 走真实 LingxingAdapter,
覆盖成功、限流失败、无平台码三种场景
---
.../common/ecommerce/sdk/CallObserverTest.java | 157 ++++++++++++++++++
.../lingxing/adapter/LingxingCallObserverTest.java | 183 +++++++++++++++++++++
2 files changed, 340 insertions(+)
create mode 100644 core/src/test/java/common/ecommerce/sdk/CallObserverTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
diff --git a/core/src/test/java/common/ecommerce/sdk/CallObserverTest.java b/core/src/test/java/common/ecommerce/sdk/CallObserverTest.java
new file mode 100644
index 0000000..552516a
--- /dev/null
+++ b/core/src/test/java/common/ecommerce/sdk/CallObserverTest.java
@@ -0,0 +1,157 @@
+package common.ecommerce.sdk;
+
+import common.ecommerce.audit.CallObserver;
+import common.ecommerce.audit.CallOutcome;
+import common.ecommerce.audit.CallRecord;
+import common.ecommerce.error.ChannelException;
+import common.ecommerce.model.ChannelProvider;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.account.AccountKey;
+import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.model.order.SalesOrder;
+import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.support.Page;
+import common.ecommerce.spi.ChannelSecret;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+import java.time.ZoneOffset;
+import java.util.ArrayList;
+import java.util.List;
+
+import static java.time.Clock.fixed;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 门面调用日志({@link CallObserver})的契约测试。
+ *
+ *
不碰网络:用 {@link ChannelSdkTest.FakeDirectAdapter} 与内存账户仓库,
+ * 验证「一次调用产生一条记录」「失败也记录」「观察者报错不影响业务」。
+ */
+class CallObserverTest {
+
+ /** 账户的 provider 必须与注册的适配器一致,否则解析不到适配器。 */
+ private static final AccountKey KEY =
+ AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-wm-001");
+
+ private static final ChannelConnection CONNECTION = ChannelConnection.of(
+ "https://api.example.com",
+ ChannelSecret.builder().appKey("ak").appSecret("sk").build());
+
+ /** 把回调记录收集到内存里,便于断言。 */
+ private static final class CollectingObserver implements CallObserver {
+
+ private final List records = new ArrayList<>();
+
+ @Override
+ public void onCall(CallRecord record) {
+ records.add(record);
+ }
+ }
+
+ private static ChannelAccount account() {
+ return ChannelAccount.builder()
+ .key(KEY)
+ .externalStoreId("wm-seller-01")
+ .credentialRef("kms://test/wm")
+ .marketplaceZone("America/Chicago")
+ .currency("USD")
+ .build();
+ }
+
+ private static ChannelSdk sdk(CallObserver observer) {
+ return ChannelSdk.builder()
+ .accountRepository(new ChannelSdkTest.FixedAccounts(account()))
+ .clock(fixed(Instant.parse("2026-11-05T00:00:00Z"), ZoneOffset.UTC))
+ .register(new ChannelSdkTest.FakeDirectAdapter())
+ .callObserver(observer)
+ .build();
+ }
+
+ @Test
+ void recordsSuccessfulCall() {
+ CollectingObserver observer = new CollectingObserver();
+ ChannelSdk sdk = sdk(observer);
+
+ Page page = sdk.salesOrders(KEY, CONNECTION).pull(
+ SalesOrderQuery.builder()
+ .updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
+ .pageSize(20)
+ .build());
+
+ assertNotNull(page);
+ assertEquals(1, observer.records.size(), "一次调用只产生一条记录");
+
+ CallRecord record = observer.records.get(0);
+ assertEquals("salesOrders.pull", record.operation());
+ assertEquals(CallOutcome.SUCCESS, record.outcome());
+ assertEquals(ChannelProvider.DIRECT, record.provider());
+ assertEquals(Platform.WALMART_SC, record.platform());
+ assertEquals("oms-wm-001", record.omsStoreId());
+ assertEquals("wm-seller-01", record.externalStoreId());
+ assertEquals(0, record.resultCount(), "FakeDirectAdapter 返回空页");
+ assertNotNull(record.requestId(), "requestId 用于串起 HTTP 日志");
+ assertEquals(20, record.params().get("pageSize"));
+ assertFalse(record.failed());
+ assertEquals(0L, record.durationMillis(), "固定时钟下耗时为 0");
+
+ // Instant 本身永远是 UTC(toString 带 Z);本地时间要用带 ZoneId 的重载
+ assertEquals("2026-11-05T00:00:00Z", record.occurredAt().toString());
+ assertEquals("2026-11-05T08:00+08:00",
+ record.occurredAt(java.time.ZoneId.of("Asia/Shanghai"))
+ .toOffsetDateTime().toString());
+ }
+
+ @Test
+ void recordsFailedCallAndRethrows() {
+ CollectingObserver observer = new CollectingObserver();
+ ChannelSdk sdk = sdk(observer);
+
+ // FakeDirectAdapter 没有商品能力:能力检查在门面里失败
+ assertThrows(ChannelException.UnsupportedCapabilityException.class,
+ () -> sdk.products(KEY, CONNECTION).pull(ProductQuery.builder().build()));
+
+ assertEquals(1, observer.records.size());
+ CallRecord record = observer.records.get(0);
+ assertEquals("products.pull", record.operation());
+ assertEquals(CallOutcome.FAILURE, record.outcome());
+ assertTrue(record.failed());
+ assertTrue(record.errorType().contains("UnsupportedCapabilityException"),
+ record.errorType());
+ assertNotNull(record.errorMessage());
+ }
+
+ @Test
+ void observerFailureDoesNotBreakBusinessCall() {
+ CallObserver broken = new CallObserver() {
+ @Override
+ public void onCall(CallRecord record) {
+ throw new IllegalStateException("observer down");
+ }
+ };
+ ChannelSdk sdk = sdk(broken);
+
+ // 观察者抛异常被吞掉,业务结果照常返回
+ Page page = sdk.salesOrders(KEY, CONNECTION).pull(
+ SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).build());
+ assertNotNull(page);
+ }
+
+ @Test
+ void defaultObserverIsNoop() {
+ // 不注入 callObserver 时不应该有任何副作用,也不应该 NPE
+ ChannelSdk sdk = ChannelSdk.builder()
+ .accountRepository(new ChannelSdkTest.FixedAccounts(account()))
+ .register(new ChannelSdkTest.FakeDirectAdapter())
+ .build();
+
+ Page page = sdk.salesOrders(KEY, CONNECTION).pull(
+ SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).build());
+ assertEquals(0, page.size());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
new file mode 100644
index 0000000..6b84496
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
@@ -0,0 +1,183 @@
+package common.ecommerce.lingxing.adapter;
+
+import common.ecommerce.audit.CallObserver;
+import common.ecommerce.audit.CallOutcome;
+import common.ecommerce.audit.CallRecord;
+import common.ecommerce.error.ChannelException;
+import common.ecommerce.http.JacksonJsonCodec;
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.lingxing.support.LingxingTestSupport;
+import common.ecommerce.model.ChannelProvider;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.model.order.SalesOrder;
+import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.model.support.Page;
+import common.ecommerce.sdk.ChannelConnection;
+import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.spi.ChannelSecret;
+import common.ecommerce.testkit.InMemoryAccounts;
+import common.ecommerce.testkit.InMemoryLockProvider;
+import common.ecommerce.testkit.InMemoryTokenStore;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 领星 + ChannelSdk 的调用日志测试。
+ *
+ * 用 {@link RecordingTransport} 替掉网络,走真实的 {@link LingxingAdapter},
+ * 验证操作日志记录的是领星账户的真实链路:provider=LINGXING、platform=领取子平台、
+ * store_id=领星 store_id。
+ */
+class LingxingCallObserverTest {
+
+ private static final String ORDER_JSON =
+ "{"
+ + "\"code\":0,\"message\":\"操作成功\","
+ + "\"data\":{\"total\":1,\"list\":[{"
+ + "\"global_order_no\":\"GO-1\","
+ + "\"store_id\":\"store-1\","
+ + "\"amount_currency\":\"USD\","
+ + "\"status\":6,"
+ + "\"global_purchase_time\":1759363200,"
+ + "\"item_info\":[{"
+ + "\"global_item_no\":\"GI-1\",\"msku\":\"SKU-1\",\"quantity\":2,"
+ + "\"unit_price_amount\":\"9.99\",\"tax_amount\":\"0.00\","
+ + "\"discount_amount\":\"0.00\"}],"
+ + "\"platform_info\":[{"
+ + "\"platform_code\":\"10008\",\"platform_order_no\":\"PO-1\","
+ + "\"platform_order_name\":\"PO-1\","
+ + "\"store_Country_code\":\"US\",\"purchase_time\":1759363200}],"
+ + "\"transaction_info\":[{\"order_total_amount\":\"19.98\"}]"
+ + "}]}"
+ + "}";
+
+ private static final String RATE_LIMITED_JSON =
+ "{\"code\":3001008,\"message\":\"请求过于频繁\"}";
+
+ /** 收集回调记录,避免依赖 SLF4J 绑定。 */
+ private static final class CollectingObserver implements CallObserver {
+
+ private final List records = new ArrayList();
+
+ @Override
+ public void onCall(CallRecord record) {
+ records.add(record);
+ }
+ }
+
+ private static ChannelConnection connection() {
+ return ChannelConnection.of(
+ LingxingTestSupport.ENDPOINT,
+ ChannelSecret.builder()
+ .appKey(LingxingTestSupport.APP_KEY)
+ .appSecret(LingxingTestSupport.APP_SECRET)
+ .build());
+ }
+
+ private static ChannelSdk sdk(RecordingTransport transport, ChannelAccount account,
+ CallObserver observer) {
+ LingxingAdapter adapter = new LingxingAdapter(
+ transport, new JacksonJsonCodec(),
+ new InMemoryTokenStore(), new InMemoryLockProvider(),
+ LingxingTestSupport.CLOCK);
+
+ return ChannelSdk.builder()
+ .accountRepository(new InMemoryAccounts().put(account))
+ .clock(LingxingTestSupport.CLOCK)
+ .register(adapter)
+ .callObserver(observer)
+ .build();
+ }
+
+ private static SalesOrderQuery query() {
+ return SalesOrderQuery.builder()
+ .updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
+ .updatedBefore(Instant.parse("2026-10-08T00:00:00Z"))
+ .pageSize(20)
+ .build();
+ }
+
+ @Test
+ void recordsSuccessfulLingxingCall() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(ORDER_JSON));
+ ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 10008, "store-1");
+ CollectingObserver observer = new CollectingObserver();
+
+ Page page = sdk(transport, account, observer)
+ .salesOrders(account.key(), connection()).pull(query());
+
+ assertEquals(1, page.size());
+ assertEquals("PO-1", page.items().get(0).channelOrderId());
+
+ assertEquals(1, observer.records.size());
+ CallRecord record = observer.records.get(0);
+ assertEquals("salesOrders.pull", record.operation());
+ assertEquals(CallOutcome.SUCCESS, record.outcome());
+ assertEquals(ChannelProvider.LINGXING, record.provider());
+ assertEquals(Platform.WALMART_SC, record.platform());
+ assertEquals(account.omsStoreId(), record.omsStoreId());
+ assertEquals("store-1", record.externalStoreId());
+ assertEquals(1, record.resultCount());
+ assertNotNull(record.requestId());
+ assertEquals(20, record.params().get("pageSize"));
+ assertFalse(record.failed());
+
+ // 领星请求确实带了账户的 platform_code + store_id
+ String body = transport.lastDataRequest().body();
+ assertTrue(body.contains("\"platform_code\":[10008]"), body);
+ assertTrue(body.contains("\"store_id\":[\"store-1\"]"), body);
+ }
+
+ @Test
+ void recordsFailureWhenLingxingReturnsBusinessError() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(RATE_LIMITED_JSON));
+ ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 10008, "store-1");
+ CollectingObserver observer = new CollectingObserver();
+
+ assertThrows(ChannelException.class,
+ () -> sdk(transport, account, observer)
+ .salesOrders(account.key(), connection()).pull(query()));
+
+ assertEquals(1, observer.records.size());
+ CallRecord record = observer.records.get(0);
+ assertEquals("salesOrders.pull", record.operation());
+ assertEquals(CallOutcome.FAILURE, record.outcome());
+ assertTrue(record.errorType().contains("RateLimitException"), record.errorType());
+ assertTrue(record.errorMessage().contains("3001008"), record.errorMessage());
+ }
+
+ @Test
+ void recordsCallWhenAccountHasNoPlatformCode() {
+ RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(ORDER_JSON));
+ // platformCode = 0 表示不设置,对应没有平台码的长尾平台
+ ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 0, "store-1");
+ CollectingObserver observer = new CollectingObserver();
+
+ Page page = sdk(transport, account, observer)
+ .salesOrders(account.key(), connection()).pull(query());
+
+ assertEquals(1, page.size());
+ assertEquals(1, observer.records.size());
+ assertEquals(CallOutcome.SUCCESS, observer.records.get(0).outcome());
+
+ String body = Objects.requireNonNull(transport.lastDataRequest()).body();
+ assertFalse(body.contains("platform_code"), "没有平台码时不应发送该字段");
+ assertTrue(body.contains("\"store_id\":[\"store-1\"]"), body);
+ }
+}