Browse Source
- 按 AccountKey 隔离缓存:缓存键由适配器按账户维度拼出 - 提前续期:保留原有 needsRefresh 逻辑 - LockProvider 防击穿:拿不到锁时轮询等待(50ms × 最多 5s), 期间重读缓存;对方刷成功后直接复用,超时才抛 AuthException - 刷新失败不返回旧 token:不做宽限兜底,异常直接抛给调用方 - 日志只打指纹:沿用 AccessToken.fingerprint() - 人工失效/重授权:forceRefresh 删缓存后重取 领星侧 tokenKey 从 externalStoreId 改为 appKey:领星 token 按 app 发放, 同 app 多店铺应共用一个 token,避免重复换 token 烧配额。 新增 TokenManagerTest,覆盖缓存、提前续期、强制刷新、失败不留旧值、 锁被占用时不重复刷新、指纹脱敏六类场景。 Co-Authored-By: Claude <noreply@anthropic.com>feature/supplier-lingxing
4 changed files with 280 additions and 38 deletions
@ -0,0 +1,186 @@ |
|||||||
|
package common.ecommerce.http; |
||||||
|
|
||||||
|
import common.ecommerce.error.AuthException; |
||||||
|
import common.ecommerce.spi.AccessToken; |
||||||
|
import common.ecommerce.spi.ChannelSecret; |
||||||
|
import org.junit.jupiter.api.BeforeEach; |
||||||
|
import org.junit.jupiter.api.Test; |
||||||
|
|
||||||
|
import java.time.Duration; |
||||||
|
import java.time.Instant; |
||||||
|
import java.util.concurrent.atomic.AtomicInteger; |
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals; |
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows; |
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue; |
||||||
|
|
||||||
|
/** |
||||||
|
* TokenManager 对应设计文档 9.1 的五条要求。 |
||||||
|
*/ |
||||||
|
class TokenManagerTest { |
||||||
|
|
||||||
|
private static final Instant T0 = Instant.parse("2026-10-30T00:00:00Z"); |
||||||
|
private static final ChannelSecret SECRET = ChannelSecret.builder() |
||||||
|
.appKey("ak").appSecret("sk").build(); |
||||||
|
|
||||||
|
private LocalClock clock; |
||||||
|
private LocalTokenStore tokenStore; |
||||||
|
private LocalLockProvider locks; |
||||||
|
private AtomicInteger refreshes; |
||||||
|
private TokenManager manager; |
||||||
|
|
||||||
|
@BeforeEach |
||||||
|
void setUp() { |
||||||
|
clock = new LocalClock(T0); |
||||||
|
tokenStore = new LocalTokenStore(); |
||||||
|
locks = new LocalLockProvider(); |
||||||
|
refreshes = new AtomicInteger(); |
||||||
|
manager = new TokenManager(tokenStore, locks, clock, 600) { |
||||||
|
@Override |
||||||
|
protected AccessToken refresh(ChannelSecret secret, AccessToken previous) { |
||||||
|
int n = refreshes.incrementAndGet(); |
||||||
|
return AccessToken.builder() |
||||||
|
.value("token-" + n) |
||||||
|
.expiresAt(Instant.now(clock).plusSeconds(7200)) |
||||||
|
.build(); |
||||||
|
} |
||||||
|
}; |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void cachesPerTokenKey() { |
||||||
|
AccessToken a = manager.getOrRefresh("lingxing:ak", SECRET); |
||||||
|
AccessToken b = manager.getOrRefresh("lingxing:ak", SECRET); |
||||||
|
|
||||||
|
assertEquals("token-1", a.value()); |
||||||
|
assertEquals("token-1", b.value()); |
||||||
|
assertEquals(1, refreshes.get(), "second call must hit cache"); |
||||||
|
assertEquals(1, locks.acquireCount("token-refresh:lingxing:ak")); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void differentTokenKeysDoNotShareCache() { |
||||||
|
manager.getOrRefresh("lingxing:ak", SECRET); |
||||||
|
manager.getOrRefresh("lingxing:ak-2", SECRET); |
||||||
|
|
||||||
|
assertEquals(2, refreshes.get()); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void refreshesBeforeExpiry() { |
||||||
|
manager.getOrRefresh("k", SECRET); // 7200s 有效期
|
||||||
|
clock.advance(Duration.ofSeconds(7200 - 600)); // 进入提前续期窗口
|
||||||
|
AccessToken second = manager.getOrRefresh("k", SECRET); |
||||||
|
|
||||||
|
assertEquals(2, refreshes.get()); |
||||||
|
assertEquals("token-2", second.value()); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void validTokenNotRefreshedBeforeWindow() { |
||||||
|
manager.getOrRefresh("k", SECRET); |
||||||
|
clock.advance(Duration.ofSeconds(7200 - 601)); |
||||||
|
manager.getOrRefresh("k", SECRET); |
||||||
|
|
||||||
|
assertEquals(1, refreshes.get()); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void forceRefreshDropsCacheAndReFetches() { |
||||||
|
manager.getOrRefresh("k", SECRET); |
||||||
|
AccessToken forced = manager.forceRefresh("k", SECRET); |
||||||
|
|
||||||
|
assertEquals(2, refreshes.get()); |
||||||
|
assertEquals("token-2", forced.value()); |
||||||
|
assertEquals("token-2", tokenStore.get("k").get().value()); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void refreshFailurePropagatesAndKeepsNoStaleToken() { |
||||||
|
TokenManager failing = new TokenManager(tokenStore, locks, clock, 600) { |
||||||
|
@Override |
||||||
|
protected AccessToken refresh(ChannelSecret secret, AccessToken previous) { |
||||||
|
throw new AuthException(common.ecommerce.error.ChannelException.builder() |
||||||
|
.message("app not exist").operation("token.refresh")); |
||||||
|
} |
||||||
|
}; |
||||||
|
|
||||||
|
assertThrows(AuthException.class, () -> failing.getOrRefresh("k", SECRET)); |
||||||
|
assertTrue(!tokenStore.get("k").isPresent(), "no token should be written on failure"); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void lockHeldByAnotherInstanceIsNotBrokenThrough() { |
||||||
|
// 模拟另一个实例正在刷新:锁被占,缓存里也没有有效 token
|
||||||
|
locks.tryLock("token-refresh:k", 30); |
||||||
|
TokenManager quick = new TokenManager(tokenStore, locks, clock, 600) { |
||||||
|
@Override |
||||||
|
protected AccessToken refresh(ChannelSecret secret, AccessToken previous) { |
||||||
|
throw new IllegalStateException("must not be called"); |
||||||
|
} |
||||||
|
}; |
||||||
|
|
||||||
|
AuthException ex = assertThrows(AuthException.class, () -> quick.getOrRefresh("k", SECRET)); |
||||||
|
assertTrue(ex.getMessage().contains("token refresh in progress"), ex.getMessage()); |
||||||
|
assertEquals(0, refreshes.get()); |
||||||
|
} |
||||||
|
|
||||||
|
@Test |
||||||
|
void logOnlyPrintsFingerprint() { |
||||||
|
AccessToken token = AccessToken.builder() |
||||||
|
.value("super-secret-token-value") |
||||||
|
.expiresAt(T0.plusSeconds(3600)) |
||||||
|
.build(); |
||||||
|
|
||||||
|
assertTrue(token.fingerprint().startsWith("token#")); |
||||||
|
assertTrue(!token.fingerprint().contains("super-secret"), token.fingerprint()); |
||||||
|
} |
||||||
|
|
||||||
|
// ---------------------------------------------------------------- 本地替身
|
||||||
|
// http 模块不能依赖 testkit(testkit 依赖 http,会成环),这里放最小实现。
|
||||||
|
|
||||||
|
static final class LocalClock extends java.time.Clock { |
||||||
|
private Instant now; |
||||||
|
|
||||||
|
LocalClock(Instant now) { |
||||||
|
this.now = now; |
||||||
|
} |
||||||
|
|
||||||
|
@Override public java.time.ZoneId getZone() { return java.time.ZoneOffset.UTC; } |
||||||
|
@Override public java.time.Clock withZone(java.time.ZoneId zone) { return this; } |
||||||
|
@Override public Instant instant() { return now; } |
||||||
|
|
||||||
|
void advance(Duration d) { now = now.plus(d); } |
||||||
|
} |
||||||
|
|
||||||
|
static final class LocalTokenStore implements common.ecommerce.spi.TokenStore { |
||||||
|
private final java.util.Map<String, AccessToken> tokens = new java.util.HashMap<String, AccessToken>(); |
||||||
|
|
||||||
|
@Override public java.util.Optional<AccessToken> get(String key) { |
||||||
|
return java.util.Optional.ofNullable(tokens.get(key)); |
||||||
|
} |
||||||
|
@Override public void save(String key, AccessToken token) { tokens.put(key, token); } |
||||||
|
@Override public void remove(String key) { tokens.remove(key); } |
||||||
|
} |
||||||
|
|
||||||
|
static final class LocalLockProvider implements common.ecommerce.spi.LockProvider { |
||||||
|
private final java.util.Set<String> held = new java.util.HashSet<String>(); |
||||||
|
private final java.util.Map<String, Integer> counts = new java.util.HashMap<String, Integer>(); |
||||||
|
|
||||||
|
@Override public synchronized java.util.Optional<Lock> tryLock(String key, long ttlSeconds) { |
||||||
|
if (!held.add(key)) { |
||||||
|
return java.util.Optional.empty(); |
||||||
|
} |
||||||
|
Integer c = counts.get(key); |
||||||
|
counts.put(key, c == null ? 1 : c + 1); |
||||||
|
return java.util.Optional.<Lock>of(() -> { |
||||||
|
synchronized (LocalLockProvider.this) { held.remove(key); } |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
synchronized int acquireCount(String key) { |
||||||
|
Integer c = counts.get(key); |
||||||
|
return c == null ? 0 : c; |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
Loading…
Reference in new issue