fix(cache-storage): 정책 변경과 손상 뒤에도 다음 배포가 pointer를 덮어쓴다 (0929/02-01)
문제: active pointer를 읽을 때 rollback 목록 길이를 현재
retainedPreviousReleaseCount와 비교한다. 3에서 1로 줄이는 정상 설정
변경이나 pointer JSON 손상 뒤에는 읽기가 CORRUPT_DATA가 되고, 조회·
활성화·정리·inspect가 모두 여기서 멈춘다. control cache를 지우는 API가
없어 사용자가 사이트 데이터를 지우기 전까지 오프라인 캐시가 꺼진 채로
남고, cleanup이 막혀 배포마다 release cache가 쌓인다. 이번 라운드에도
Node와 실제 Cache API 3엔진에서 재현됐다.
고른 방법(지난 리뷰 4.1절의 (나)+(다)):
- (다) isActivePointer는 목록 길이를 현재 값이 아니라 정책이 허용하는
최댓값(5, MAX_RETAINED_PREVIOUS_RELEASE_COUNT)과만 비교한다. 정책
검증과 같은 상수를 쓴다. 다음 activation이 이미 하던 slice로 목록을
현재 값으로 자른다.
- (나) activateRelease는 이전 pointer 읽기가 CORRUPT_DATA면 없는
것으로 보고, 전체 재검증을 통과한 후보로 rollback 목록 없이
덮어쓴다. 일시 오류(UNAVAILABLE 등)는 지금처럼 활성화를 멈춘다.
버린 대안:
- 현상 유지 + "사이트 데이터 삭제" 안내. 운영자가 원인을 알 수 없고
캐시가 계속 쌓인다.
- control을 지우는 admin API. 포트가 늘고 호출자가 언제 불러야 하는지
알아야 한다.
- (다)만 적용. 정책 변경은 풀리지만 JSON 손상은 풀리지 않는다.
위험·한계:
- 지키던 성질은 그대로다. 검증한 후보만 활성화하고(재검증은 pointer
읽기 전에 끝난다), 조회는 manifest digest가 맞는 바이트만 돌려준다.
읽을 수 있는 pointer가 가리키는 캐시는 cleanup이 지우지 않는다.
손상 pointer 상태의 조회와 cleanup은 다음 activation까지 여전히
CORRUPT_DATA다.
- 덮어쓰면 손상 pointer의 rollback 목록을 잃는다. 원래 읽을 수 없던
값이다. 덮어쓴 뒤 cleanup이 구버전 탭이 쓰던 캐시를 지울 수 있다.
그 탭의 조회는 네트워크로 떨어진다. Service Worker drain(VD-15)을
구현하면 이 규칙을 다시 본다(지난 리뷰 4.1절 7).
- 리뷰가 "가능하면"으로 적은 3엔진 browser spec(E-2)은 추가하지
않았다. 단위 테스트(MemoryCacheStorage)로만 확인했다.
- service-worker-pwa 레시피 번들 9,665 → 9,716 / 10,000 gzip bytes.
검증:
- RED(수정 전): public-response-cache-repair.test.ts 새 2건 실패.
retained 3 → 1 뒤 조회가 { ok: false }(기대 ok:true), 잘린 pointer
뒤 다음 배포의 activate가 { ok: false }.
- GREEN: 같은 파일 8건 통과. 일시 오류 가드 테스트 1건을 함께 넣었다.
activate가 모든 pointer 실패를 무시하도록 바꾼 변이를 이 테스트가
잡는다(1건 실패 확인 뒤 되돌림).
- 회귀: public-response-cache 단위 3파일 40건 통과. tsc app·test·
service-worker·recipes 통과. 바꾼 파일 eslint 통과.
verify-documentation-readiness PASS_SCOPED. check-optional-recipes
(source) PASS.
Refs: docs/reviews/2026-09-29-maturity-review/02-adapters-browser-files-cache.md
This commit is contained in:
@@ -976,6 +976,14 @@ preflight와 정확히 2 MiB(2,097,152 bytes) cap의 stream reader로 완전히
|
||||
strict UTF-8와 runtime schema를 검증하며, cap을 넘으면 reader를 cancel하고
|
||||
`CORRUPT_DATA`로 fail-closed한다.
|
||||
|
||||
active pointer의 rollback 목록 길이는 읽을 때 현재
|
||||
`retainedPreviousReleaseCount`와 비교하지 않는다. 더 큰 값으로 쓴 pointer도
|
||||
정상으로 읽고, 다음 activation이 목록을 현재 값으로 자른다. 읽을 수 없는
|
||||
pointer(`CORRUPT_DATA`: 손상, 또는 지금 정책으로 허용되지 않는 ID)는 조회와
|
||||
cleanup을 계속 막지만, 다음 `activateRelease`가 전체 재검증을 통과한 후보로
|
||||
rollback 목록 없이 덮어쓴다. pointer 읽기의 일시 오류는 activation을 멈춘다
|
||||
(0929/02-01).
|
||||
|
||||
현재 `cleanupOwned()`와 `inspect()`는 위 ownership/integrity 경계를 지키지만
|
||||
cache count에 대한 cursor, per-invocation max count와 deadline은 제공하지 않는다.
|
||||
따라서 cache 수에 비례한 unbounded maintenance를 production boot path에
|
||||
|
||||
@@ -15,6 +15,7 @@ import {
|
||||
} from "../browser-file-storage/result.ts";
|
||||
import {
|
||||
isAllowedPublicCacheOrigin,
|
||||
MAX_RETAINED_PREVIOUS_RELEASE_COUNT,
|
||||
type PublicCacheRuntimePolicy,
|
||||
} from "./public-cache-policy.ts";
|
||||
|
||||
@@ -452,8 +453,12 @@ export function isActivePointer(
|
||||
) &&
|
||||
"rollbackCandidateCacheNames" in value &&
|
||||
Array.isArray(value.rollbackCandidateCacheNames) &&
|
||||
// 0929/02-01. The list length is not checked against the current
|
||||
// `retainedPreviousReleaseCount`: a pointer written under a larger value
|
||||
// is still a good pointer. The next activation trims the list (`slice`).
|
||||
// The ceiling is the policy's own maximum.
|
||||
value.rollbackCandidateCacheNames.length <=
|
||||
policy.retainedPreviousReleaseCount &&
|
||||
MAX_RETAINED_PREVIOUS_RELEASE_COUNT &&
|
||||
new Set(value.rollbackCandidateCacheNames).size ===
|
||||
value.rollbackCandidateCacheNames.length &&
|
||||
value.rollbackCandidateCacheNames.every(
|
||||
|
||||
@@ -35,6 +35,8 @@ export type PublicCacheSafeObserver = (
|
||||
observation: PublicCacheSafeObservation,
|
||||
) => void;
|
||||
|
||||
/** Also the longest rollback list a stored pointer may carry (0929/02-01). */
|
||||
export const MAX_RETAINED_PREVIOUS_RELEASE_COUNT = 5;
|
||||
const RELEASE_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u;
|
||||
const CACHE_PREFIX = /^[A-Za-z0-9][A-Za-z0-9._:-]{2,63}:$/u;
|
||||
const DEFAULT_PUBLIC_CONTENT_TYPE =
|
||||
@@ -123,7 +125,8 @@ export function assertPublicCachePolicy(
|
||||
policy.maxEntriesPerRelease > 10_000 ||
|
||||
!Number.isSafeInteger(policy.retainedPreviousReleaseCount) ||
|
||||
policy.retainedPreviousReleaseCount < 1 ||
|
||||
policy.retainedPreviousReleaseCount > 5 ||
|
||||
policy.retainedPreviousReleaseCount >
|
||||
MAX_RETAINED_PREVIOUS_RELEASE_COUNT ||
|
||||
!headerNameList(policy.allowedRequestHeaderNames) ||
|
||||
!headerNameList(policy.allowedVaryHeaderNames) ||
|
||||
!headerNameList(policy.allowedResponseHeaderNames) ||
|
||||
|
||||
@@ -696,18 +696,27 @@ export function createPublicResponseCacheAdapter(
|
||||
dependencies.cacheStorage!,
|
||||
policy,
|
||||
);
|
||||
if (!previousPointer.ok) {
|
||||
// 0929/02-01. An unreadable pointer (damaged, or no longer valid
|
||||
// under this policy) is replaced by this verified candidate with
|
||||
// an empty rollback list, rather than blocking every later
|
||||
// deployment. A transient read failure still stops activation.
|
||||
if (
|
||||
!previousPointer.ok &&
|
||||
previousPointer.error.code !== "CORRUPT_DATA"
|
||||
) {
|
||||
return rebaseFailure(
|
||||
previousPointer.error,
|
||||
"CACHE_ACTIVATE",
|
||||
);
|
||||
}
|
||||
const previous = previousPointer.ok
|
||||
? previousPointer.value
|
||||
: null;
|
||||
const rollbackCandidateCacheNames = [
|
||||
...(previousPointer.value
|
||||
...(previous
|
||||
? [
|
||||
previousPointer.value.candidateCacheName,
|
||||
...previousPointer.value
|
||||
.rollbackCandidateCacheNames,
|
||||
previous.candidateCacheName,
|
||||
...previous.rollbackCandidateCacheNames,
|
||||
]
|
||||
: []),
|
||||
]
|
||||
|
||||
@@ -1,7 +1,15 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
import type { PublicCacheAsset } from "../../src/application/ports/browser-file-storage/cache-storage-ports.ts";
|
||||
import { createDefaultPublicCachePolicy } from "../../src/adapters/cache-storage/public-cache-policy.ts";
|
||||
import {
|
||||
activePointerRequest,
|
||||
controlCacheName,
|
||||
} from "../../src/adapters/cache-storage/public-cache-codec.ts";
|
||||
import {
|
||||
createDefaultPublicCachePolicy,
|
||||
resolvePublicCachePolicy,
|
||||
type PublicCacheRuntimePolicy,
|
||||
} from "../../src/adapters/cache-storage/public-cache-policy.ts";
|
||||
import { createPublicResponseCacheAdapter } from "../../src/adapters/cache-storage/public-response-cache-adapter.ts";
|
||||
import {
|
||||
MemoryCacheStorage,
|
||||
@@ -243,3 +251,150 @@ describe("public response cache repair is failure-atomic", () => {
|
||||
).toMatchObject({ ok: true });
|
||||
});
|
||||
});
|
||||
|
||||
/**
|
||||
* 0929/02-01. The active pointer was checked against the policy of the build
|
||||
* reading it, so lowering `retainedPreviousReleaseCount` or a damaged pointer
|
||||
* stopped lookup, activation and cleanup for good.
|
||||
*/
|
||||
describe("public cache pointer after a policy change or damage (0929/02-01)", () => {
|
||||
const origin = "https://assets.example.test";
|
||||
const policyRetaining = (retainedPreviousReleaseCount: number) =>
|
||||
resolvePublicCachePolicy({
|
||||
...createDefaultPublicCachePolicy(origin),
|
||||
retainedPreviousReleaseCount,
|
||||
});
|
||||
const assetUrl = (releaseRegistryId: string) =>
|
||||
`${origin}/${releaseRegistryId}.js`;
|
||||
const body = (releaseRegistryId: string) =>
|
||||
new TextEncoder().encode(`release ${releaseRegistryId}`);
|
||||
|
||||
function adapterFor(
|
||||
cacheStorage: MemoryCacheStorage,
|
||||
policy: PublicCacheRuntimePolicy,
|
||||
) {
|
||||
return createPublicResponseCacheAdapter({
|
||||
cacheStorage: cacheStorage as unknown as CacheStorage,
|
||||
crypto: globalThis.crypto,
|
||||
mutationLock: immediateLock,
|
||||
policy,
|
||||
fetcher: async (request: Request) =>
|
||||
new Response(
|
||||
Uint8Array.from(
|
||||
body(new URL(request.url).pathname.slice(1, -".js".length)),
|
||||
),
|
||||
{
|
||||
headers: {
|
||||
"cache-control": "public",
|
||||
"content-type": "application/javascript",
|
||||
},
|
||||
},
|
||||
),
|
||||
});
|
||||
}
|
||||
|
||||
async function manifestOf(
|
||||
releaseRegistryId: string,
|
||||
policy: PublicCacheRuntimePolicy,
|
||||
) {
|
||||
const bytes = body(releaseRegistryId);
|
||||
return await manifestFor(
|
||||
releaseRegistryId,
|
||||
[
|
||||
{
|
||||
absoluteUrl: assetUrl(releaseRegistryId),
|
||||
expectedByteLength: bytes.byteLength,
|
||||
expectedContentType: "application/javascript",
|
||||
integrity: { algorithm: "SHA-256", digestHex: await digestHex(bytes) },
|
||||
},
|
||||
],
|
||||
policy,
|
||||
);
|
||||
}
|
||||
|
||||
async function deploy(
|
||||
adapter: ReturnType<typeof adapterFor>,
|
||||
releaseRegistryId: string,
|
||||
policy: PublicCacheRuntimePolicy,
|
||||
) {
|
||||
const manifest = await manifestOf(releaseRegistryId, policy);
|
||||
expect(await adapter.admin.stageRelease(manifest)).toMatchObject({
|
||||
ok: true,
|
||||
});
|
||||
return await adapter.admin.activateRelease(
|
||||
manifest.releaseRegistryId,
|
||||
manifest.manifestDigestHex,
|
||||
);
|
||||
}
|
||||
|
||||
it("keeps working after retainedPreviousReleaseCount is lowered", async () => {
|
||||
const cacheStorage = new MemoryCacheStorage();
|
||||
const before = policyRetaining(3);
|
||||
const wide = adapterFor(cacheStorage, before);
|
||||
for (const id of ["r1", "r2", "r3", "r4"]) {
|
||||
expect(await deploy(wide, id, before)).toMatchObject({ ok: true });
|
||||
}
|
||||
|
||||
const after = policyRetaining(1);
|
||||
const narrow = adapterFor(cacheStorage, after);
|
||||
|
||||
expect(
|
||||
await narrow.responses.matchActiveExact({ absoluteUrl: assetUrl("r4") }),
|
||||
).toMatchObject({ ok: true, value: expect.anything() });
|
||||
expect(await deploy(narrow, "r5", after)).toMatchObject({ ok: true });
|
||||
expect(await narrow.admin.cleanupOwned()).toMatchObject({ ok: true });
|
||||
expect(
|
||||
await narrow.responses.matchActiveExact({ absoluteUrl: assetUrl("r5") }),
|
||||
).toMatchObject({ ok: true, value: expect.anything() });
|
||||
});
|
||||
|
||||
it("replaces a damaged pointer on the next verified activation", async () => {
|
||||
const cacheStorage = new MemoryCacheStorage();
|
||||
const policy = policyRetaining(1);
|
||||
const adapter = adapterFor(cacheStorage, policy);
|
||||
expect(await deploy(adapter, "r1", policy)).toMatchObject({ ok: true });
|
||||
const control = await cacheStorage.open(controlCacheName(policy));
|
||||
await control.put(
|
||||
activePointerRequest(policy),
|
||||
new Response('{"schemaVersion":1,"releaseRegis', {
|
||||
headers: { "content-type": "application/json" },
|
||||
}),
|
||||
);
|
||||
|
||||
// A release that was never staged is still refused.
|
||||
const unstaged = await manifestOf("r9", policy);
|
||||
expect(
|
||||
await adapter.admin.activateRelease(
|
||||
unstaged.releaseRegistryId,
|
||||
unstaged.manifestDigestHex,
|
||||
),
|
||||
).toMatchObject({ ok: false });
|
||||
|
||||
expect(await deploy(adapter, "r2", policy)).toMatchObject({ ok: true });
|
||||
expect(await adapter.admin.cleanupOwned()).toMatchObject({ ok: true });
|
||||
expect(
|
||||
await adapter.responses.matchActiveExact({ absoluteUrl: assetUrl("r2") }),
|
||||
).toMatchObject({ ok: true, value: expect.anything() });
|
||||
});
|
||||
|
||||
it("still stops activation when the pointer read fails transiently", async () => {
|
||||
const cacheStorage = new MemoryCacheStorage();
|
||||
const policy = policyRetaining(1);
|
||||
const adapter = adapterFor(cacheStorage, policy);
|
||||
expect(await deploy(adapter, "r1", policy)).toMatchObject({ ok: true });
|
||||
const control = cacheStorage.caches.get(controlCacheName(policy))!;
|
||||
const realMatch = control.match.bind(control);
|
||||
control.match = async () => {
|
||||
throw new DOMException("Storage is busy", "InvalidStateError");
|
||||
};
|
||||
|
||||
expect(await deploy(adapter, "r2", policy)).toMatchObject({
|
||||
ok: false,
|
||||
error: { code: "UNAVAILABLE", operation: "CACHE_ACTIVATE" },
|
||||
});
|
||||
control.match = realMatch;
|
||||
expect(
|
||||
await adapter.responses.matchActiveExact({ absoluteUrl: assetUrl("r1") }),
|
||||
).toMatchObject({ ok: true, value: expect.anything() });
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user