fix(runtime-vapor): prune KeepAlive composite cache keys

edison1105 · edison1105 · commit e2cf58a95e3c · 2026-03-19T10:53:12.000+08:00
diff --git a/packages/runtime-vapor/__tests__/components/KeepAlive.spec.ts b/packages/runtime-vapor/__tests__/components/KeepAlive.spec.ts
@@ -1765,6 +1765,101 @@ describe('VaporKeepAlive', () => {
     expect(keptAliveScopes.size).toBe(0)
   })
 
+  test('should recreate composite cache key after max prunes keyed branch entry', async () => {
+    const Comp = defineVaporComponent({
+      name: 'Comp',
+      props: ['id'],
+      setup() {
+        return template('<div></div>')()
+      },
+    })
+
+    const toggle = ref(true)
+    const { instance } = define({
+      setup() {
+        return createComponent(
+          VaporKeepAlive,
+          { max: () => 1 },
+          {
+            default: () =>
+              // index=0 makes this a keyed DynamicFragment
+              createIf(
+                () => toggle.value,
+                () => createComponent(Comp, { id: () => 'a' }),
+                () => createComponent(Comp, { id: () => 'b' }),
+                undefined,
+                undefined,
+                0,
+              ),
+          },
+        )
+      },
+    }).render()
+
+    const keepAliveInstance = instance!.block as any
+    const cache = keepAliveInstance.__v_cache as Map<any, any>
+
+    await nextTick()
+    expect(cache.size).toBe(1)
+    const keyA1 = Array.from(cache.keys())[0]
+
+    toggle.value = false
+    await nextTick()
+    expect(cache.size).toBe(1)
+    const keyB = Array.from(cache.keys())[0]
+    expect(keyB).not.toBe(keyA1)
+
+    toggle.value = true
+    await nextTick()
+    expect(cache.size).toBe(1)
+    const keyA2 = Array.from(cache.keys())[0]
+
+    expect((keyA1 as any).branchKey).toBe((keyA2 as any).branchKey)
+    expect(keyA2).not.toBe(keyA1)
+  })
+
+  test('should recreate composite cache key after KeepAlive hmr rerender', async () => {
+    const Comp = defineVaporComponent({
+      name: 'Comp',
+      props: ['id'],
+      setup() {
+        return template('<div></div>')()
+      },
+    })
+
+    const toggle = ref(true)
+    const { instance } = define({
+      setup() {
+        return createComponent(VaporKeepAlive, null, {
+          default: () =>
+            createIf(
+              () => toggle.value,
+              () => createComponent(Comp, { id: () => 'a' }),
+              () => createComponent(Comp, { id: () => 'b' }),
+              undefined,
+              undefined,
+              0,
+            ),
+        })
+      },
+    }).render()
+
+    const keepAliveInstance = instance!.block as any
+    const cache = keepAliveInstance.__v_cache as Map<any, any>
+
+    await nextTick()
+    expect(cache.size).toBe(1)
+    const keyA1 = Array.from(cache.keys())[0]
+
+    keepAliveInstance.hmrRerender!()
+    await nextTick()
+
+    expect(cache.size).toBe(1)
+    const keyA2 = Array.from(cache.keys())[0]
+    expect((keyA1 as any).branchKey).toBe((keyA2 as any).branchKey)
+    expect(keyA2).not.toBe(keyA1)
+  })
+
   test('handle error in async onActivated', async () => {
     const err = new Error('foo')
     const handler = vi.fn()
diff --git a/packages/runtime-vapor/src/components/KeepAlive.ts b/packages/runtime-vapor/src/components/KeepAlive.ts
@@ -79,20 +79,24 @@ export interface KeepAliveInstance extends VaporComponentInstance {
   }
 }
 
-type CacheKey = VaporComponent | VNode['type']
+const COMPOSITE_KEY: unique symbol = Symbol('keepAliveCompositeKey')
+
+type BaseCacheKey = VaporComponent | VNode['type']
+type CacheKey = BaseCacheKey | CompositeKey
 type Cache = Map<CacheKey, VaporComponentInstance | VaporFragment>
 type Keys = Set<CacheKey>
 type CompositeKey = {
-  type: CacheKey
+  type: BaseCacheKey
   branchKey: any
+  [COMPOSITE_KEY]: true
 }
 
 // Returns a stable composite key object for a given (type, branchKey) pair.
 // Caches are passed as parameters (per KeepAlive instance) to avoid
 // module-level Map leaks for primitive type keys (e.g. string tag names
 // from VDOM interop).
 function getCompositeKey(
-  type: CacheKey,
+  type: BaseCacheKey,
   branchKey: any,
   compositeKeyCache: WeakMap<object, Map<any, CompositeKey>>,
   compositeKeyCachePrimitive: Map<any, Map<any, CompositeKey>>,
@@ -109,12 +113,37 @@ function getCompositeKey(
 
   let composite = perType.get(branchKey)
   if (!composite) {
-    composite = { type, branchKey }
+    composite = { type, branchKey, [COMPOSITE_KEY]: true }
     perType.set(branchKey, composite)
   }
   return composite
 }
 
+function deleteCompositeKey(
+  key: CacheKey,
+  compositeKeyCache: WeakMap<object, Map<any, CompositeKey>>,
+  compositeKeyCachePrimitive: Map<any, Map<any, CompositeKey>>,
+): void {
+  if (!isObject(key) || !(COMPOSITE_KEY in key)) return
+
+  const { type, branchKey } = key as CompositeKey
+  const isObjectType = isObject(type) || isFunction(type)
+  const perType = isObjectType
+    ? compositeKeyCache.get(type)
+    : compositeKeyCachePrimitive.get(type)
+
+  if (!perType || perType.get(branchKey) !== key) return
+
+  perType.delete(branchKey)
+  if (perType.size) return
+
+  if (isObjectType) {
+    compositeKeyCache.delete(type)
+  } else {
+    compositeKeyCachePrimitive.delete(type)
+  }
+}
+
 const VaporKeepAliveImpl = defineVaporComponent({
   name: 'VaporKeepAlive',
   __isKeepAlive: true,
@@ -150,7 +179,7 @@ const VaporKeepAliveImpl = defineVaporComponent({
     const compositeKeyCachePrimitive = new Map<any, Map<any, CompositeKey>>()
 
     const resolveKey = (
-      type: VaporComponent | VNode['type'],
+      type: BaseCacheKey,
       key?: any,
       branchKey?: any,
     ): CacheKey => {
@@ -205,7 +234,10 @@ const VaporKeepAliveImpl = defineVaporComponent({
       const rerender = keepAliveInstance.hmrRerender
       keepAliveInstance.hmrRerender = () => {
         keepAliveInstance.exposed = null
-        cache.forEach(cached => resetCachedShapeFlag(cached))
+        cache.forEach((cached, key) => {
+          resetCachedShapeFlag(cached)
+          deleteCompositeKey(key, compositeKeyCache, compositeKeyCachePrimitive)
+        })
         cache.clear()
         keys.clear()
         keptAliveScopes.forEach(scope => scope.stop())
@@ -351,6 +383,7 @@ const VaporKeepAliveImpl = defineVaporComponent({
       }
       cache.delete(key)
       keys.delete(key)
+      deleteCompositeKey(key, compositeKeyCache, compositeKeyCachePrimitive)
       const scope = deleteScope(key)
       if (scope) scope.stop()
     }
