fix(prerender): edge cases in option caching

Author: harlan-zw

src/build/prerender.ts

@@ -32,18 +32,19 @@ export function setupPrerenderHandler(options: ModuleOptions, resolve: Resolver,
 
     // Track hash-mode OG URLs whose source page isn't in the prerender graph.
     // These 404 at context.ts because the page's defineOgImage() never ran so
-    // the hash:<hash> cache entry was never written. Clear the error so the build
-    // doesn't fail, and warn once at the end of prerender so users can investigate.
+    // the hash:<hash> cache entry was never written. Clear the error so nitro
+    // doesn't add them to failedRoutes (which would fail the build).
+    // Must use prerender:generate (fires before failedRoutes check), not
+    // prerender:route (fires after — too late to prevent the build failure).
     const orphanedOgHashes: string[] = []
-    nitro.hooks.hook('prerender:route', (route) => {
+    nitro.hooks.hook('prerender:generate', (route) => {
       if (!route.error || route.error.statusCode !== 404)
         return
       if (!route.route.includes('/_og/s/o_'))
         return
       orphanedOgHashes.push(route.route)
-      route.error = undefined
-      route.contents = ''
-      route.fileName = undefined
+      route.skip = true
+      delete route.error
     })
 
     nitro.hooks.hook('prerender:done', async () => {

src/runtime/app/utils.ts

@@ -146,6 +146,9 @@ export function createOgImageMeta(src: string, input: OgImageOptions | OgImagePr
         if (component?.hash)
           urlOpts._componentHash = component.hash
         const result = buildOgImageUrl(urlOpts, extension, isStatic, defaults, ogImageConfig.security?.secret || undefined)
+        // Propagate hash so prerender plugin can store it in prerenderOptionsCache
+        if (result.hash)
+          opts._hash = result.hash
         const resolvedUrl = joinURL('/', baseURL, result.url)
         const finalUrl = opts._query && Object.keys(opts._query).length
           ? withQuery(resolvedUrl, { _query: opts._query })