fix(runtime-core): skip patching reserved props for custom elements (#14275)

danielroe · web-flow · commit 19cc7e2cd053 · 2026-01-19T08:52:43.000+08:00
close #14274
diff --git a/packages/runtime-core/__tests__/hydration.spec.ts b/packages/runtime-core/__tests__/hydration.spec.ts
@@ -1597,6 +1597,24 @@ describe('SSR hydration', () => {
     expect((container.firstChild as any).foo).toBe(msg.value)
   })
 
+  // #14274
+  test('should not render ref on custom element during hydration', () => {
+    const container = document.createElement('div')
+    container.innerHTML = '<my-element>hello</my-element>'
+    const root = ref()
+    const app = createSSRApp({
+      render: () =>
+        h('my-element', {
+          ref: root,
+          innerHTML: 'hello',
+        }),
+    })
+    app.mount(container)
+    expect(container.innerHTML).toBe('<my-element>hello</my-element>')
+    expect((container.firstChild as Element).hasAttribute('ref')).toBe(false)
+    expect(root.value).toBe(container.firstChild)
+  })
+
   // #5728
   test('empty text node in slot', () => {
     const Comp = {
diff --git a/packages/runtime-core/src/hydration.ts b/packages/runtime-core/src/hydration.ts
@@ -507,7 +507,7 @@ export function createHydrationFunctions(
               (isOn(key) && !isReservedProp(key)) ||
               // force hydrate v-bind with .prop modifiers
               key[0] === '.' ||
-              isCustomElement
+              (isCustomElement && !isReservedProp(key))
             ) {
               patchProp(el, key, null, props[key], undefined, parentComponent)
             }

Original file line number	Diff line number	Diff line change
`@@ -507,7 +507,7 @@ export function createHydrationFunctions(`
`507`	`507`	`(isOn(key) && !isReservedProp(key)) \|\|`
`508`	`508`	`// force hydrate v-bind with .prop modifiers`
`509`	`509`	`key[0] === '.' \|\|`
`510`		`- isCustomElement`
	`510`	`+ (isCustomElement && !isReservedProp(key))`
`511`	`511`	`) {`
`512`	`512`	`patchProp(el, key, null, props[key], undefined, parentComponent)`
`513`	`513`	`}`