`nuxt dev` reload never finishes when a Nuxt `close` hook doesn't settle

Ouverte
#1,659 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
72/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
node.js, nuxt, typescript
Domaine
backend, cli

Piste de recherche

Start in packages/nuxt-cli/src/dev/utils.ts at #load() and close(), then read the shutdown budget in packages/nuxt-cli/src/dev/pool.ts and its closeFork logic. Check existing dev reload tests and add coverage for a Nuxt close hook that never settles. Done means reload proceeds after the shutdown deadline, reports the unfinished hooks, and the test passes.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Environment
  • @nuxt/cli 4.0.3 (same code on main, 7d4dec6)
  • nuxt 4.6.4, nitropack 2.13.6, vite 8.3.6
  • Node 24.22.2, Linux x64
Reproduction

https://github.com/mttzzz/nuxt-reload-close-hook-hang

The app has one local module:

// modules/hang-on-close.ts
import { defineNuxtModule } from 'nuxt/kit'

export default defineNuxtModule({
  meta: { name: 'hang-on-close' },
  setup(_options, nuxt) {
    nuxt.hook('close', () => new Promise<void>(() => {}))
  },
})
  1. npm i && npx nuxt dev, the page shows marker: one
  2. change marker: 'one' to 'two' in nuxt.config.ts
Describe the bug

After step 2 the page switches to the loading screen (503) and stays there (I waited 80 s), the reload is never reported as done. Saving nuxt.config.ts again does nothing, since the config watcher is closed before the reload and only re-armed after it. Ctrl-C still exits right away, so restarting nuxt dev is the only way out.

Without the module the same edit reloads in about 1 s. The same kind of hook in a Nitro plugin (nitroApp.hooks.hook('close', () => new Promise(() => {}))) only delays the reload by about 5 s: nitropack terminates the dev worker after NITRO_SHUTDOWN_TIMEOUT, and the reload goes on.

This came up in #1328, where @danielroe asked for a separate issue.

Cause

An in-place reload (a nuxt.config change, removed build output, nuxt.callHook('restart') from a module) goes through #load(), which awaits close(), and close() awaits this.#currentNuxt.close() with no deadline:

https://github.com/nuxt/cli/blob/7d4dec65b188e549faad7c219d3766c988e5cdcb/packages/nuxt-cli/src/dev/utils.ts#L1277-L1282

nuxt.close() calls the close hooks one after another, so the hooks registered after the module (Nitro's, Vite's, the builder watchers) are never called either.

Shutting the fork down already has a budget: closeFork waits DEV_SHUTDOWN_TIMEOUT_MS (10 s), then sends SIGTERM and SIGKILL:

https://github.com/nuxt/cli/blob/7d4dec65b188e549faad7c219d3766c988e5cdcb/packages/nuxt-cli/src/dev/pool.ts#L194-L212

The reload could get the same budget: race currentNuxt.close() against DEV_SHUTDOWN_TIMEOUT_MS, warn that the close hooks didn't finish, and go on with the reload. I can send a PR for that.

Langage dominant
TypeScript
Étoiles
402
Forks
125
Merge moyen
2 j 9 h
PR mergées (30 j)
37

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de nuxt/cli

Toutes les issues de nuxt/cli

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.