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

オープン
#1,659 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
72/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
node.js, nuxt, typescript
領域
backend, cli

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語
TypeScript
スター
402
フォーク
125
平均マージ
2日 9時間
マージ済み PR(30日)
37

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

nuxt/cli のほかの issue

nuxt/cli の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。