Nuxt · NUXT0024

Register custom keyed data composables

Finds Nuxt fetch code that can be written with a clearer framework-supported pattern.

NUXT0024vite-doctor/nuxtfetchingwarnSuggestion

nuxt/fetch/keyed-composable-registration-requiredsrc/rule-packs/nuxt/rules/nuxt/keyed-composable-registration-required.ts Upstream docs

Run this rule

pnpm nuxt doctor --rules nuxt/fetch/keyed-composable-registration-required

Why it matters

Nuxt data fetching relies on stable keys, payload serialization, and request context. Bypassing those contracts can duplicate requests or lose SSR data.

Recommended fix

Use the Nuxt-supported keyed composable registration required pattern instead.

Useful links

Rule reference

Example

Use keyed composable registration required

Before

export const useUser = createUseFetch('/api/user')

export default defineNuxtConfig({})

After

export const useUser = createUseFetch('/api/user')

export default defineNuxtConfig({
  optimization: {
    keyedComposables: [
      { name: 'useUser', argumentLength: 2 },
    ],
  },
})