Nextjsの環境ごとのenvファイルの読み込み

2024-06-23

6 months ago

開発環境

Nextjsでのenvファイルについてまとめます。

どのプロジェクトでも環境変数を利用すると思います。

Nextjsにおいては、いくつかのenvファイルを活用することで、環境ごとに設定する値を管理することができます。

環境 (NODE_ENVで設定) に応じて、環境変数は次のソースから１〜４の順序で読み込まれます。

すべての環境において、.envに関しては最後に読み込まれるので、上書きされことはありません。

テスト環境では .env.local はロードされません
Nextjsのプロジェクトを新規で作成するとデフォルトで.env*.localのみ.gitignoreに記載されています。.env*.localファイルはシークレット値を保存できる場所を想定しているからです。それ以外のenvファイルにはシークレットな値は格納せず、レポジトリに含めるべきです。

使い分けや読み込み順は知っていないと戸惑うことが多いので、ぜひ参考にしてみてください。