概要

Bunでパッケージのインストールが失敗する場合のエラーと解決方法です。

エラーメッセージ

``` error: Failed to install “package-name” ```

原因

1. ネイティブモジュールの互換性: Node.js用バイナリがBunで動かない
2. postinstallスクリプトの失敗: npm scriptが失敗
3. lockfileの不整合: bun.lockbとpackage.jsonの差異
4. キャッシュの破損: グローバルキャッシュの問題

解決策

1. キャッシュをクリア

```bash

Bunのキャッシュをクリア

bun pm cache rm

node_modulesを削除して再インストール

rm -rf node_modules bun.lockb bun install ```

2. trustDependenciesを設定

```json // package.json { “trustedDependencies”: [“esbuild”, “sharp”] } ```

3. ネイティブモジュールの代替を使用

```bash

bcrypt の代わりに bcryptjs

bun remove bcrypt bun add bcryptjs

sharp の代わりに jimp (純JavaScript)

bun remove sharp bun add jimp ```

4. –no-saveでテスト

```bash

lockfileを更新せずにインストール

bun install –no-save ```

5. Node.jsとの互換性モード

```bash

Node.js互換モードで実行

bun –bun run build ```

よくある間違い

• Node.js用のnative addonをそのまま使用
• package-lock.jsonとbun.lockbを混在
• Bunでサポートされていないpostinstall script

関連エラー

• npm: ERESOLVE dependency
• pnpm: Peer dependency