React Nativeの「sharpモジュール」エラーを確実に解決する方法

React Nativeアプリを起動しようとした際に、以下のようなエラーメッセージが表示されて困ったことはありませんか？

Something went wrong installing the "sharp" module

このエラーの原因はいくつか考えられ、解決方法も複数存在します。

エラーが発生する主な原因

筆者の経験上、このエラーは最新版のNode.jsをインストールした直後に発生することが多いようです。sharpは画像処理を行うネイティブモジュールであり、Node.jsのバージョンに依存してビルドされます。そのため、Node.jsをアップデートすると、既存のnode_modules内にあるsharpのバイナリが新しいバージョンと互換性を失い、エラーが発生するのです。

確実に効果のある解決策

筆者が毎回成功している解決策は、アプリのルートフォルダ内にあるnode_modulesを、以下のコマンドで削除することです。

rm -rf node_modules

注意：node_modulesフォルダは手動で削除せず、必ず上記のコマンドを使って削除してください。手動削除では隠しファイルやシンボリックリンクが正しく消えず、問題が残る可能性があります。

モジュールの再インストール

上記のコマンドを実行した後、お好みのパッケージマネージャーを使ってnodeモジュールを再インストールしましょう。

yarnを使用する場合：

yarn

または、npmを使用する場合：

npm install

再インストールが完了したら、アプリを再度起動してみてください。sharpモジュールが新しいNode.jsのバージョンに合わせて正しくビルドされ、エラーが解消されるはずです。

それでも解決しない場合

上記の手順で改善しない場合は、パッケージマネージャーのキャッシュをクリアしてから再度インストールを試みてください。

yarn cache clean

または

npm cache clean --force

これにより、破損したキャッシュが原因で発生するエラーも解消できる可能性があります。