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 @@
@@ -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