🎉
Next.jsとYarnのエラー解決: Node.jsバージョン不一致の修正方法
エラー内容
yarn installを実行した際に、以下のエラーが発生しました。
error next@14.2.4: The engine "node" is incompatible with this module.
Expected version ">=18.17.0". Got "16.20.2"
error Found incompatible module.
対応手順
1. Node.jsバージョンの確認と更新
現在のNode.jsバージョンを確認し、必要なバージョンをインストールします。
nodenv -v
nodenv install -l
nodenv install 18.17.0
nodenv global 18.17.0
nodenv rehash
2. パスの更新
環境変数の設定ファイル（~/.zshrc）を編集し、Node.jsのバージョンパスを更新します。
nano ~/.zshrc
以下の行を見つけて、
export PATH=$PATH:/Users/owner/.nodenv/versions/16.20.2/bin
上記を以下に変更します。
export PATH=$PATH:/Users/owner/.nodenv/versions/18.17.0/bin
に変更します。
設定を反映するために以下のコマンドを実行します。
source ~/.zshrc
3. Yarnキャッシュのクリアと再インストール
依存関係のクリーンアップを行い、再インストールします。
rm -rf yarn.lock node_modules
yarn cache clean
yarn install --force
4. 開発サーバーの起動
すべてが正常に動作することを確認するために、開発サーバーを起動します。
yarn dev
以下のようにビルドが成功すれば完了です。
$ yarn dev
yarn run v1.22.19
$ next dev -p 3003
▲ Next.js 14.2.4
- Local: http://localhost:3003
- Environments: .env.development
✓ Starting...
✓ Ready in 3.3s
○ Compiling / ...
✓ Compiled / in 2.7s (1195 modules)
ビルド成功🙌
参考
Discussion