エラー: EACCES: 許可が拒否されました
EACCES: permission deniedエラーは、特にnpm (Node Package Manager) を使用しているNode.js開発者にとって大きな悩みの種となりがちです。このエラーは、Node.jsまたはnpmがファイルやディレクトリへのアクセスを試みたものの、必要な権限がなかったことを意味します。通常、グローバルパッケージのインストール、スクリプトの実行、またはプロジェクト固有のnode_modulesフォルダを操作する際に発生します。
説明と根本原因
根本的に、EACCESはファイルシステムアクセスに特に関連するオペレーティングシステムのエラーです。「許可が拒否されました」と表示される場合、現在のユーザーアカウントが特定の操作に必要な読み取り、書き込み、または実行の権限を持っていないことを意味します。Node.jsおよびnpmユーザーにとって、最も一般的なシナリオは以下の通りです。
- グローバルnpmパッケージのインストール: デフォルトでは、npmはグローバルパッケージをシステム全体のディレクトリにインストールしようとします。例えば、macOSでは
/usr/local、Linuxでは/usr/binや/usr/local/binがこれにあたります。これらの場所は通常、変更を加えるためにroot（管理者）権限を必要とします。sudoなしでグローバルパッケージをインストールしようとすると、すぐに権限の問題に直面します。 - 以前の
sudo使用による不適切な権限:npm install -gやローカルなnpm installをsudoで実行したことはありませんか？もしそうであれば、一部のファイルやディレクトリがroot所有で作成または変更された可能性があります。その後、通常のユーザーとしてこれらのファイルを管理しようとすると、必然的にEACCESエラーに遭遇します。 - 破損したnpmキャッシュ: 時折、npmキャッシュが破損することがあります。これには不適切な権限を持つファイルが含まれている場合があり、その後のパッケージインストール時に問題を引き起こします。
- プロジェクト固有の
node_modulesまたはビルドディレクトリ: 頻度は少ないものの、特定のプロジェクト内でこのエラーに直面することがあります。もしそのプロジェクトのnode_modulesディレクトリやビルド出力フォルダが別のユーザーによって所有されているか、または過度に制限された権限を持っている場合、ローカルスクリプトの実行やアプリケーションのビルド時に問題が発生する可能性が高いです。
段階的な修正方法
オプション1: npmのデフォルトディレクトリを設定する（グローバルパッケージに推奨）
この方法は、グローバルnpmパッケージを扱う上で最も安全で推奨される方法です。システムディレクトリの権限を調整するのではなく、npmにグローバルパッケージをユーザーアカウントが所有するディレクトリにインストールするよう指示するだけです。
- npmの現在のグローバルディレクトリを確認します:
npm config get prefix
通常、`/usr/local`や`/usr/bin`のような出力が表示されます。
- **グローバルインストール専用のディレクトリを作成します:** ユーザーのホームディレクトリ内に場所を選びます。`~/.npm-global`が広く受け入れられている慣習です。
```bash
mkdir -p ~/.npm-global
- npmにこの新しいディレクトリを使用するよう設定します:
npm config set prefix '~/.npm-global'
- **新しいディレクトリをPATHに追加します:** この重要なステップは、npmがグローバルにインストールする実行ファイルをシェルが特定できるようにするために必要です。シェルの設定ファイル（`~/.bashrc`、`~/.zshrc`、または`~/.profile`が一般的です）を開き、以下の行を挿入します:
```bash
export PATH="~/.npm-global/bin:$PATH"
行を追加したら、ファイルを保存します。その後、ターミナルを再起動するか、ファイルをソースすることによって変更を適用します:
```bash
source ~/.bashrc # または ~/.zshrc, ~/.profile
#### オプション2: 既存のディレクトリの権限を修正する（注意して使用）
デフォルトのシステムロケーションにグローバルパッケージをインストールすることを好む場合や、一時的な権限問題に直面しているだけかもしれません。そのような場合、問題のあるnpmディレクトリの所有者を変更することを選択できます。このアプローチは長期的なグローバルパッケージ管理には理想的ではありませんが、差し迫った問題を解決するには間違いなく有効です。
**警告:** `sudo`と`chown`を使用する際は細心の注意を払ってください。これらのコマンドの誤用は、システムを不安定にする可能性があります。
- **影響を受けるディレクトリを特定します:** 通常、npmのグローバルインストールディレクトリとnpmキャッシュディレクトリの両方を特定する必要があります。
```bash
npm config get prefix
npm config get cache
例えば、プレフィックスは/usr/local、キャッシュは~/.npmまたは/Users/YOUR_USER/.npmになることがあります。
- ディレクトリの所有者を変更します:
<NPM_PREFIX_DIR>と<NPM_CACHE_DIR>を前のステップで見つけた実際のパスに置き換えてください。必要であれば、$(whoami)を使用する代わりに自分のユーザー名を入力しても構いません。
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} sudo chown -R $(whoami) $(npm config get cache)
ご参考までに、`lib/node_modules`、`bin`、`share`はグローバルパッケージとその実行ファイルのための標準的なサブディレクトリです。
#### オプション3: プロジェクト固有の権限を修正する
特定のNode.jsプロジェクトディレクトリ内で`EACCES`エラーが発生していますか？例えば、`npm install`や`npm start`をローカルで実行しようとしたときなどです。そのような場合、プロジェクトファイルまたはその`node_modules`ディレクトリの所有権が誤っている可能性が非常に高いです。
- **プロジェクトディレクトリに移動します:**
```bash
cd /path/to/your/project
- プロジェクトディレクトリの所有者を変更します: このコマンドは、プロジェクト内のすべてのファイルとサブディレクトリの所有者を、現在のユーザーに再帰的に変更します。
sudo chown -R $(whoami) .
**重要:** このコマンドを実行する前に、正しいプロジェクトディレクトリにいることを二重に確認してください！
#### オプション4: npmキャッシュをクリアする
時に、破損した、または権限がロックされたnpmキャッシュが`EACCES`エラーの原因となることがあります。
- **npmキャッシュをクリアします:**
```bash
npm cache clean --force
このコマンドは、npmキャッシュからすべてのデータを完全に削除します。キャッシュ自体に権限の問題がある場合、クリアする前にオプション2で説明されているキャッシュディレクトリの所有者変更とこのステップを組み合わせる必要があるかもしれません。
検証
これらの修正の1つ以上を適用したら、問題が本当に解決されたことを確認することが不可欠です。以前に失敗したアクションを再度試してください。
- グローバルパッケージの問題（オプション1または2の場合）: 新しいグローバルパッケージのインストールを試します。
nodemonは良いテスト候補です:
npm install -g nodemon
`nodemon`が`EACCES`エラーなしで正常にインストールされれば、修正は成功です！
- **プロジェクト固有の問題（オプション3または4の場合）:** プロジェクトの依存関係をインストールするか、プロジェクトスクリプトを実行してみてください。
```bash
cd /path/to/your/project
npm install
npm start # または失敗していた他のスクリプト
これらのコマンドが権限エラーなしでスムーズに実行されれば、プロジェクトの権限は正しくなっている可能性が高いです。
将来的なEACCESエラーを避けるためのヒント
sudo npm installは決して使わない（絶対に必要な場合を除く）:sudoでnpmコマンドを実行することは、ほとんどの場合一時的な回避策に過ぎません。ファイル所有権をrootに変更することで、後々より多くの問題を引き起こすことがよくあります。代わりに、オプション1のような方法でnpmを適切に設定するようにしてください。- Node Version Manager (NVM) または Volta を活用する: NVM (Node Version Manager) やVoltaのようなツールは状況を一変させます。これらを使用すると、複数のNode.jsバージョンとその関連npmパッケージを完全にユーザーのホームディレクトリ内にインストールおよび管理できます。これにより、グローバルパッケージのためにシステムディレクトリに書き込む必要が完全に回避され、グローバルインストールにおける
EACCESエラーを効果的に排除できます。 - 共有開発環境に注意する: 共有環境（例: 仮想マシンやチームサーバー）で共同作業している場合は、常に自分のユーザーアカウントがすべてのプロジェクトディレクトリに対して適切な権限を持っていることを確認してください。