From 5962988f86bc44c30ae51e4f03d9d2449ce66f81 Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Thu, 12 Nov 2026 15:47:33 +0800
Subject: [PATCH] =?UTF-8?q?feat(edayun):=20token=20=E6=8E=A5=E5=8F=A3?=
=?UTF-8?q?=E7=9C=9F=E6=9C=BA=E9=AA=8C=E8=AF=81=E9=80=9A=E8=BF=87=EF=BC=8C?=
=?UTF-8?q?=E6=8C=89=E5=AE=9E=E9=99=85=E6=8A=A5=E6=96=87=E4=BF=AE=E6=AD=A3?=
=?UTF-8?q?=E8=A7=A3=E6=9E=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
真机调用(PR 环境):
POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
{"client_id":"openapi-test","client_secret":"123456"}
→ HTTP 200 {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
文档与实际不符的两处,已按实测调整:
1. 响应是**扁平结构**,没有 code、没有 data 包裹。
原来强制要求 code,会把成功当失败。改为:缺 code 不算失败,
交给「有没有 access_token」判断;显式给了非 200 的 code 才判失败。
2. 响应**没有有效期字段**(文档说「永久,建议留窗口刷新」),也没有
refresh_token。expiresAt 改为明确的估算值语义:让 TokenManager 定期
重登一次,不是真的到期。
DTO 补了顶层 access_token / token_type / scope,data 保留为兼容分支。
探针 EdayunTokenProbeTest 实跑结果:token 取到(脱敏输出)、
tokenType=bearer、剩 7200 秒、refreshToken=null。
测试 13 个(新增 acceptsFlatShapeWithoutCode 固化实测形态;
missingCodeIsRejected 改为 missingCodeWithoutTokenIsRejected,
报「no access token」而不是「no code」)。
全量 535 个测试通过。
Co-Authored-By: Claude
待联调确认:文档只给了 {@code code} 的取值(200 / 500 / 503 / 504), - * 没给响应体结构。所以这里同时兼容三种常见形态:
- *都取不到时按 500 处理并带出原始报文(截断)。
+ *实测(2026-11-12,PR 环境):成功响应的 body 是扁平结构,没有 {@code code}:
+ *
+ * HTTP 200
+ * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
+ *
+ *
+ * token 是永久的(文档:「目前设计上是永久的,建议留个窗口刷新」), + * 响应里没有有效期字段。所以 {@code expiresAt} 是个估算值——用于让 + * {@code TokenManager} 定期重登一次,而不是真的到期。
+ * + *兼容分支:若网关把结果包一层 {@code data} 或返回 {@code code}, + * 也按对应形态解析(生产环境确认后可删)。
*/ public final class EdayunTokenClient { @@ -99,6 +103,10 @@ public final class EdayunTokenClient { /** * 业务码:200 成功;500 失败;503 网关无效;504 超时。 * + *实测该接口不返回 {@code code}——HTTP 200 + body 里有 access_token + * 就是成功。所以 {@code code} 缺失时不算失败,交给后续的 token 存在性校验; + * 只有显式给了非 200 的 code 才判失败。
+ * *503 通常是网关问题、504 是超时,都值得重试;500 是明确失败,不重试。
*/ private void requireBusinessOk(EdayunTokenDtos.TokenResponse parsed, String body) { @@ -107,7 +115,8 @@ public final class EdayunTokenClient { } Integer code = parsed.code; if (code == null) { - throw validation("edayun token response has no code", body); + // 实测:扁平结构没有 code,视为成功,由 tokenOf 校验 token 是否存在 + return; } if (code == EdayunConstants.CODE_SUCCESS) { return; @@ -124,25 +133,34 @@ public final class EdayunTokenClient { .build(); } - /** 三种形态都试一遍;都取不到就失败,不猜。 */ + /** + * 取 token:实测是顶层 {@code access_token};兼容 {@code data.access_token} + * 与顶层 {@code token}。都取不到就失败,不猜。 + */ private String tokenOf(EdayunTokenDtos.TokenResponse parsed, String body) { + if (hasText(parsed.accessToken)) { + return parsed.accessToken.trim(); + } if (parsed.data != null && hasText(parsed.data.accessToken)) { return parsed.data.accessToken.trim(); } - // 顶层 token(部分网关会把 data 拍平) String topLevel = json.stringAt(body, "token"); if (hasText(topLevel)) { return topLevel.trim(); } throw validation("edayun token response has no access token" - + " (looked for data.access_token and token)", body); + + " (looked for access_token, data.access_token and token)", body); } /** - * 过期时刻。 + * 过期时刻(估算)。 + * + *实测响应没有有效期字段,文档也说 token「目前设计上是永久的, + * 建议留个窗口刷新」。所以这里返回一个估算值,作用只是让 {@code TokenManager} + * 定期重登一次,避免真出问题时卡死。
* - *优先 {@code data.expires_in}(相对秒),其次 {@code data.expiry}(绝对), - * 都没有就按 {@link EdayunConstants#DEFAULT_TOKEN_TTL_SECONDS} 兜底并标注待确认。
+ *若将来响应里出现 {@code data.expires_in} 或 {@code data.expiry}, + * 优先用真值。
*/ private Instant expiresAtOf(EdayunTokenDtos.TokenResponse parsed) { Instant now = Instant.now(clock); @@ -156,6 +174,7 @@ public final class EdayunTokenClient { return absolute; } } + // 文档:token 永久,建议定期刷新。按兜底周期重登一次。 return now.plusSeconds(EdayunConstants.DEFAULT_TOKEN_TTL_SECONDS); } diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java index 5259d3a..de9f590 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunTokenDtos.java @@ -34,18 +34,42 @@ public final class EdayunTokenDtos { /** * 获取 token 响应。 * - *待联调确认:文档只给了 {@code code} 的取值约定 - * (200 成功 / 500 失败 / 503 网关无效 / 504 超时),没有给响应体结构。 - * 这里按常见形态预留了 {@code data.access_token} / {@code expires_in} / - * {@code expiry},实际字段名以真机返回为准。
+ *实测(2026-11-12,PR 环境):响应是扁平结构,没有 {@code code} + * 也没有 {@code data} 包裹:
+ *
+ * {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
+ *
+ *
+ * token 是永久的(文档原话「目前设计上是永久的,建议留个窗口刷新」), + * 响应里没有有效期字段,所以过期时刻只能按兜底值估算。
+ * + *{@code data} 保留为兼容分支:万一生产环境走了网关包装也能解析。
*/ public static final class TokenResponse { - /** 200 成功 / 500 失败 / 503 网关无效 / 504 超时。 */ + /** 业务码;实测该接口不返回,仅在网关包装的场景出现。 */ public Integer code; public String message; - /** 业务载荷;字段名待确认。 */ + /** 实测的顶层字段:access token。 */ + @JsonProperty("access_token") + public String accessToken; + /** + * 实测的顶层字段:{@code bearer}(小写)。 + * + *{@code AccessToken} 的默认值是 {@code Bearer}(首字母大写);业务请求里 + * 易达云用的是独立的 {@code token} 头而不是 {@code Authorization} 头, + * 所以这个类型值目前不参与签名,原样保留即可。
+ */ + @JsonProperty("token_type") + public String tokenType; + /** 实测的顶层字段:scope,如 {@code server}。 */ + public String scope; + /** 刷新令牌;该接口不返回。 */ + @JsonProperty("refresh_token") + public String refreshToken; + + /** 兼容分支:网关把结果包一层 data 时使用。 */ public TokenData data; /** token 载荷。 */ diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java index a51e107..19a76c1 100644 --- a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/auth/EdayunTokenClientTest.java @@ -56,6 +56,21 @@ class EdayunTokenClientTest { // ------------------------------------------------------------ 响应形态 + /** 实测形态:HTTP 200 + 扁平 body,没有 code。 */ + @Test + void acceptsFlatShapeWithoutCode() { + RecordingTransport transport = RecordingTransport.create() + .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok( + "{\"access_token\":\"0dabff46-0492-44bc-9283-64163dc8a995\"," + + "\"token_type\":\"bearer\",\"scope\":\"server\"}")); + + AccessToken token = client(transport).fetch(BASE, "openapi-test", "123456"); + + assertEquals("0dabff46-0492-44bc-9283-64163dc8a995", token.value()); + // 响应无有效期字段,按兜底周期估算 + assertEquals(Instant.parse("2026-11-12T02:00:00Z"), token.expiresAt()); + } + @Test void acceptsOauthStandardShape() { RecordingTransport transport = RecordingTransport.create() @@ -133,12 +148,15 @@ class EdayunTokenClientTest { } } + /** 实测无 code;但 body 里也没有 token,所以要报「没有 access token」。 */ @Test - void missingCodeIsRejected() { + void missingCodeWithoutTokenIsRejected() { RecordingTransport transport = RecordingTransport.create() .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok("{\"message\":\"ok\"}")); - assertThrows(ValidationException.class, () -> client(transport).fetch(BASE, "u", "p")); + ValidationException ex = assertThrows(ValidationException.class, + () -> client(transport).fetch(BASE, "u", "p")); + assertTrue(ex.getMessage().contains("no access token"), ex.getMessage()); } @Test