Nitro · Server

NITRO0010Do not use app composables in Nitro server files

Nuxt app composables are not available from Nitro server files.

Why it happens

Server handlers run with Nitro request context, not Vue setup context. App composables like useRoute(), useFetch(), and useHead() depend on the Nuxt app runtime.

Fix

Use event-aware Nitro utilities in server handlers.

Example

Avoid client composables in server handlers

Before

export default defineEventHandler(() => {
  return useRoute().path
})

After

export default defineEventHandler((event) => {
  return getRequestURL(event).pathname
})

Verify the fix

Run only this rule after editing so the report stays focused on the diagnostic you are closing:

pnpm vite-doctor . --framework nitro --rules nitro/server/no-client-composables
Copyright © 2026