npm installのEINTEGRITYエラーの原因と直し方

​​npm​Node.js,トラブルシュート

npm install や npm ci が npm error code EINTEGRITY で止まったら、package-lock.json に記録されたハッシュ(integrity)と、実際にダウンロードしたパッケージのハッシュが食い違っています。npm view <パッケージ>@<バージョン> dist.integrity でレジストリの値を調べ、package-lock.json のほうが違っていれば、そのパッケージを npm install で入れ直すか、Git で package-lock.json を元に戻すとエラーは消えます。

手元では通るのに、CI(GitHub Actions など)や別の PC の npm install・npm ci だけがこのエラーで止まる、という場面でも同じ見方で原因を切り分けられます。私は検証環境でこのエラーを起こし、出たメッセージの全文と、直すと消えることを確かめました。

補足

検証環境は Ubuntu 24.04 で、主に Node.js 22.23.4(npm 10.9.9)、比べるために Node.js 24.22.1(npm 11.19.1)でも試しました。例のパッケージは is-number 7.0.0、レジストリは標準の registry.npmjs.org です。エラーは、package-lock.json の integrity を書き換えるか、中身を変えた tarball を検証環境の中のサーバーから出して起こしました。Windows と macOS、実際の CI サービス、社内レジストリなどの実在のサーバー、yarn や pnpm は試していません。

エラーの全文

npm init -y で作ったプロジェクトに npm install is-number@7.0.0 で is-number を入れ、package-lock.json の is-number の integrity だけを別の値に書き換えました。node_modules を消して npm install を実行すると、npm 10.9.9 では次のように出て止まりました(終了コードは1)。ログファイルのパスは ~/.npm/_logs に置き換えています。時間を測るために time を付けて実行したので、最後の3行はその結果です。

text
$ time npm install
npm warn tarball tarball data for is-number@https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz (sha512-AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ==) seems to be corrupted. Trying again.
npm warn tarball tarball data for is-number@https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz (sha512-AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ==) seems to be corrupted. Trying again.
npm error code EINTEGRITY
npm error sha512-AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ== integrity checksum failed when using sha512: wanted sha512-AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQ== but got sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==. (3730 bytes)
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-14T01_43_36_687Z-debug-0.log

real	2m20.589s
user	0m0.402s
sys	0m0.040s

最初の2行の警告は「tarball のデータが壊れているようなので、もう一度取りに行く」という意味です。警告は、取りに行ったデータが合わないたびに1回出ます。2回とも合わなかったので、3行目以降のエラーで止まりました。後半の節で検証環境の中のサーバーから取らせたときも、サーバーに届いたリクエストは2回で、警告も2回でした。node_modules は作られませんでした。

npm ci でも、出たメッセージは同じでした。npm 11.19.1 でも、警告とエラーの文は同じでした。

止まるまでの時間は、この検証では npm install が2分20秒、npm ci が1分10秒ほどでした。設定の fetch-retries(既定は2)を0にして同じ npm install を実行すると、0.4秒ほどで止まりました。

wanted と got が何を指しているか

4行目のエラーの文は、ssri というライブラリが組み立てています(npm 10.9.9 に同梱のソースで確認)。読むところは次の3つです。

部分 中身
wanted sha512-… 期待していたハッシュ。この例では package-lock.json の integrity に書いた値
but got sha512-… 実際にダウンロードしたデータから計算したハッシュ
(3730 bytes) ダウンロードしたデータの大きさ

行頭の sha512-AQEB… は、wanted と同じ値です。integrity は、そのパッケージの tarball のハッシュを記録した項目です(package-lock.json の公式ドキュメント)。

レジストリの値と比べて、どちらが違うかを見分ける

wanted と got のどちらが正しいかは、レジストリが公開しているハッシュと比べると分かります。npm view で、バージョンまで指定して dist.integrity を出します。

text
$ npm view is-number@7.0.0 dist.integrity
sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==

この例では、レジストリの値が got と同じで、wanted とは違いました。つまり、package-lock.json に記録された値のほうが間違っています。この場合の直し方は、次の節の2つです。

逆に、wanted がレジストリの値と同じで、got だけが違うこともあります。そのときは、ダウンロードしたデータのほうが違っています。このあとの「ダウンロードしたデータのほうが違うとき」の節で扱います。

package-lock.json のほうが違うときの直し方

パッケージを指定して入れ直す

エラーになったパッケージを、バージョンまで指定して npm install します。

text
$ npm install is-number@7.0.0

added 1 package, and audited 2 packages in 355ms

found 0 vulnerabilities

package-lock.json の integrity がレジストリと同じ sha512-41Cif… に書き換わりました。書き換える前に写しておいた package-lock.json と cmp で比べると、まったく同じでした。続けて node_modules を消して npm ci を実行すると、エラーは出ずに終わりました(終了コードは0)。

text
$ rm -rf node_modules && npm ci

added 1 package, and audited 2 packages in 320ms

found 0 vulnerabilities

Git で package-lock.json を元に戻す

正しい package-lock.json がコミットしてあるなら、そこに戻すのが確実です。検証では、正しい状態をコミットしてから integrity を書き換え、git checkout package-lock.json で戻しました。そのあとの npm ci は、エラーなしで終わりました。

text
$ git checkout package-lock.json && git status --short
Updated 1 path from the index
?? node_modules/

npm cache clean –force では直らない

npm のキャッシュを消せば直るかも試しました。npm cache clean --force を実行してから npm install しても、同じ EINTEGRITY で止まりました。間違っているのは package-lock.json の値なので、キャッシュを消してダウンロードし直しても、届くデータのハッシュは変わりません。

npm cache の公式ドキュメントにも、キャッシュを通るデータは入れるときと取り出すときにすべて検証され、壊れていればエラーになるか自動で取り直すので、ディスクの空きを作る以外の目的でキャッシュを消す必要はない、と書かれています。

実際に、キャッシュの中の is-number の tarball を broken という6バイトの文字列に書き換えてから npm install すると、cached data … seems to be corrupted. Refreshing cache. と警告が出たあと、エラーにならずに入りました。キャッシュが壊れているだけでは、EINTEGRITY にはなりませんでした。

ダウンロードしたデータのほうが違うとき

検証環境の中に、中身を少し変えた is-number の tarball を出すサーバーを立てました。package-lock.json の integrity は正しいまま、resolved(tarball の取得先)だけをそのサーバーに向けました。

text
"resolved": "http://127.0.0.1:8080/is-number-7.0.0.tgz",
"integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",

キャッシュが空の状態で npm install を実行すると、今度は wanted がレジストリと同じ値で、got が違う値になりました(ログファイルのパスは置き換えています)。

text
$ rm -rf node_modules && npm install
npm warn tarball tarball data for is-number@http://127.0.0.1:8080/is-number-7.0.0.tgz (sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==) seems to be corrupted. Trying again.
npm warn tarball tarball data for is-number@http://127.0.0.1:8080/is-number-7.0.0.tgz (sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==) seems to be corrupted. Trying again.
npm error code EINTEGRITY
npm error sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng== integrity checksum failed when using sha512: wanted sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng== but got sha512-ylNTafYtykIZmBq0pRo3DkEYrYuE4VlvmkTzw9Zb6sD/aeqhvbh6gsktv9Yz+LbYzDnYMOD2PX2FB0ccKYPjgw==. (3794 bytes)
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-14T01_47_13_943Z-debug-0.log

この形のときは、package-lock.json を書き換えて合わせるのではなく、最初の警告の行に出ている URL(tarball data for is-number@ のあと)を見て、どこからデータを取っているかを確かめます。検証では、package-lock.json を Git で元に戻し、キャッシュが空の状態で npm ci を実行すると、エラーなしで終わりました。入った is-number の index.js は、変える前の中身でした。

同じ package-lock.json でも、正しい tarball がキャッシュに残っている環境では、このエラーは出ませんでした。resolved を書き換えたあと、キャッシュがある状態で npm install すると成功し、サーバーへのリクエストは1件も記録されませんでした。手元では通るのに CI でだけ止まるときは、手元のキャッシュに正しいデータが残っているだけ、ということがあります。

注意

package-lock.json から integrity の行を消すと、エラーは消えます。検証では、間違った integrity でエラーになる状態から行を消すと、npm install が通りました。ただし、そのあと npm install や npm ci を実行しても、integrity の行は戻りませんでした。この状態で resolved を中身を変えた tarball のサーバーに向けると、エラーにならずに入り、index.js の末尾に書き足した // changed がそのまま入っていました。データが違っていても気づけなくなるので、この直し方は使わないほうが安全です。

​Posted by 86