Next.js 16(Turbopack) + dev container(Docker Desktop WSL)でホットリロードが効かない問題

目的

• 開発速度を上げるためにホットリロードを有効化したい
• 開発環境はDocker(dev container)に閉じ込めたい

結論

以下のいずれか

• Next.js 16でデフォルト有効となっている Turbopack ではなく、 webpack を使う (next dev --webpack)
  • ※ ホットリロードは遅い
• WSLを使わない。Docker Desktopの場合、設定から Use the WSL 2 based engineのチェックを外す
  • 
  • (これを選択しました)
• [未検証] WindowsファイルシステムをWSLにマウントしない

調査ログ

• コンテナ環境での開発時にホットリロードを有効化するための設定として、以下（のいずれか）がよく見られる
  • next.config.tsで webpack のwatchOptionsを設定する
    • https://github.com/vercel/next.js/issues/36774#issuecomment-1121069327
  • 環境変数WATCHPACK_POLLINGを設定する(≒webpackのwatchOptions設定)
    • webpack/watchpack: Wrapper library for directory and file watching.
    • ※ 昔は webpack/watchpack ではなく chokidar を使っており、環境変数はCHOKIDAR_USEPOLLINGだった
      • https://github.com/webpack/watchpack/issues/130#issuecomment-607364798

        • new version uses watchpack without chokidar

• しかし、2025/10リリースのNext.js 16からwebpackではなくTurbopackがデフォルトで使われるようになり、webpack/watchpackに依存する、watchOptionsやWATCHPACK_POLLINGは効かなくなった
  • https://nextjs.org/docs/app/api-reference/turbopack

    • Turbopack is now the default bundler in Next.js.

    • "dev": "next dev",

    • ※ next dev --webpack でwebpackに戻せる、が、遅かった
  • https://nextjs.org/docs/15/app/api-reference/turbopack#getting-started

    • "dev": "next dev --turbopack",

• Turbopack + WSLでホットリロードが効かないのは、WSL2の問題らしい
  • [WSL2] File changes made by Windows apps on Windows filesystem don't trigger notifications for Linux apps · Issue #4739 · microsoft/WSL
    • 2025/12/29 現在未解決
• [未検証] WindowsファイルシステムをWSLにマウントしなければ良いらしい
  • https://github.com/vercel/next.js/issues/36774#issuecomment-1275306579
• Turbopackにもファイルをpollingする設定があるらしいが、ドキュメントが無い＆壊れている可能性もありそう
  • Issue: Turbopack Watch does not see changes when running in Docker Container · Issue #68255 · vercel/next.js
    • 対応PR: feat(turbopack): add support for polling file watcher by ForsakenHarmony · Pull Request #69684 · vercel/next.js
  • Docs: how to enable turbopack's polling feature for the file watcher? · Issue #80665 · vercel/next.js
    • 2025/12/29 現在未解決