技術選定・運用設計読了約16分

引き継いだアプリのnpm audit結果の読み方|直す・様子見・置き換え

npm auditの20件は部品の数。同じ版内の更新で10件に減りました。

記事の概要図

引き継いだWebアプリの診断を、別の開発会社に頼みました。数日後に届いた報告書には、「部品に既知の弱点が20件あり、うち致命的が6件」と書かれています。見積の項目には「部品の更新作業」が並んでいますが、金額の大きい順に並んでいるのか、どれから手を付けるのか、発注した側には判断がつきません。致命的と書かれているものを全部直さないと使い続けられないのか、それとも一部は様子を見てよいのか。ほかの会社に聞いても、答えが分かれます。こんなことはないでしょうか。

この記事では、前の2本の記事と同じダミーのWebアプリ(Node.js、部品9個)で、実際にnpm auditを動かしました。20件の内訳を読み、何もしない、自動修正、同じ大きな版の中で更新、すべて最新へ更新の4通りを試して、件数と、画面の応答がどう変わるかを比べています。確かめたのは2026年11月17日の1回分で、今回の題材に限った結果です。守る側の読み方だけを書き、攻撃の手順は扱いません。

この記事で分かること

結論から言うと、npm auditの「20件」は問題の数ではなく部品の数で、今回の題材では、同じ大きな版の中で更新すると10件に減り、最新の大きな版へ上げても5件が残りました。残った部品は、版を上げても解けず、置き換えが必要でした。

  • npm auditの20件が何を数えたものか、直接と間接、深刻度の読み方
  • 自動修正(audit fix)が効かなかった実例と、同じ大きな版の中で更新したときの件数の変化
  • 「直す」「様子を見る」「置き換える」の分かれ目と、開発会社に聞く質問の記入例

1. 検証したこと

題材は、見積依頼を記録するダミーのアプリです。実在の会社のコードではありません。部品(直接使うもの)は9個で、すべて2017年から2018年に公開された版で固定されています。

環境は、macOS 27.2.1、Node.js v22.22.0、npm 11.3.0です。部品の導入は、導入時のスクリプトを動かさない指定(--ignore-scripts)で行いました。外から実行ファイルを取らないためです。DB接続の部分は、前の記事と同じく、Node.js内蔵のSQLiteを使う形に替えたコピーで動かしています。

手順は次のとおりです。

A何もしない(受け取った版のまま)基準の件数を出す
Bnpm audit fix(自動修正)自動修正がどこまで直すかを見る
D同じ大きな版(メジャー)の中で、各部品を最新へ影響の小さい更新で、どこまで減るかを見る
C9部品すべてを、最新の大きな版へ大きく上げた場合の件数と、動作の変化を見る

それぞれ、新しい空のフォルダにコピーして行い、原本は触っていません。操作のあとに、画面とボタンを順に呼ぶ10回の確認(ログイン、一覧、登録、詳細、状態変更など)を毎回流しました。結果の見方は、すべて200か302(正常)、存在しない番号だけ404(期待どおり)です。

かかった時間は、コマンドの実行時間で、部品の導入が1秒から3秒、確認の10回が数秒でした。1つの操作につき、1分もかかっていません。出力を読んで表にまとめる時間は計っていません。

うまくいかなかった所は、確認の途中で、サーバーを立てる番号(3000番)をすでに別のプログラムが使っていたことに気づき、3917番に替えて確認をやり直したことです。結果は同じでした。また、部品を入れる前にnpm audit fixを打った最初の試しは、ロックファイルが無いためエラーで止まり、部品を入れてからやり直した結果を使っています。また、4通りの確認でnpm audit fix --forceそのものは動かしておらず、Cでは、同じ効果を狙って各部品の最新版を直接指定しました。

確認した日は2026年11月17日です。npm auditの結果は、その日の登録簿の内容と照らしたものなので、日が変われば件数が変わることがあります。

4通りの手当てと、そのあとの件数。何もしないと20件、自動修正でも20件、同じ版の中で更新して10件、最新へ上げて5件

2. npm auditの「20件」は、何を数えた数字なのか

問題の数ではなく、指摘が付いた部品の数です。

何もしない状態(A)で、npm auditを動かしました。

npm auditの出力の冒頭。部品ごとに、深刻度、指摘の題、依存の経路、修正方法が並ぶ

出力は全部で183行ありました。先頭の31行を画面に載せています。1つの部品につき、次の4つが並びます。

部品名と、影響する版の範囲body-parser <=1.20.8今入っている版が、この範囲に入っているか
深刻度(Severity)highnpmが付けた段階(低、中、高、致命的)
指摘の題入力の受け取りで負荷が高まる、などその部品にどんな種類の問題があるか
修正の案内fix available via npm audit fix --force直し方の案内。--forceは大きな版替えを含む

この出力から、数え方で2つ気づきました。

1つ目は、「20件」が問題の数ではなく、部品の数だということです。たとえばbody-parserの項目には、指摘の題が3行並んでいました。3つの指摘が1つの部品の1件として数えられています。報告書に「20件」と書かれていても、20個の別々の問題があるのではありません。

2つ目は、直接と間接の区別です。

20件の内訳。深刻度、直接か間接か、部品名、npmが提案する直し方の一覧

内訳を数えると、直接使う部品が9件(すべて)、間接が11件でした。間接とは、直接使う部品が内部で使っている部品です。発注側から見れば、直接の部品は「このアプリが選んで使っている部品」、間接は「選んだ部品の中身」です。直接の部品の版を上げると、間接の部品も一緒に入れ替わることがよくあります。

読むときに、もう1つの落とし穴があります。npmの「提案」の欄に出る部品名は、その行の部品とは限りません。画面では、通信の部品requestの行に、提案としてsqlite3@4.2.0が出ています。これは「その部品を含む上位の部品を上げれば直る」という意味です。ところがあとで確認すると、sqlite3を同じ版の中で最新(4.2.0)に上げても、requestの致命的は残りました(後述のD)。提案の欄は、直る見込みとして読み、直ったかどうかは必ず再度の実行で確かめます。

3. npm audit fix を打っても、なぜ件数が減らなかったのか

今回は版が1つに固定されていたためと考えていますが、これは推定で、固定を外した確認はしていません。

次に、B(npm audit fix)を動かしました。公式資料では、npm audit fixは、依存の範囲を変えなくてよい修正だけを自動で適用するとされています。範囲を変える必要がある場合は--forceが必要になる、という説明もあります。

結果は、20件のままでした。実行後に、直接使う9部品の版を確認しましたが、1つも動いていません。

原因は、部品の指定の書き方だと考えられます。この題材の部品一覧(package.json)は、"express": "4.16.4"のように、版が1つに固定された書き方でした。「4.16.4以上の4.x」のような幅のある指定であれば、範囲の中で自動で上がります。固定されていると、範囲の中に直した版が無いため、自動修正は何もできません。これは今回の結果から考えた理由で、固定を外して再度試す確認は、していません。

引き継いだアプリでは、版を1つに固定している書き方がよく見られます。固定には、勝手に更新されず再現性が高いという利点があります。一方、弱点の指摘が出たときには、自動修正が効きにくくなります。報告書に「audit fixを実行済み」と書かれていても、このような場合は件数が変わっていない可能性があります。「実行後の件数」を必ず併記してもらいます。

4. 同じ大きな版の中で更新すると、どこまで減るのか

今回の題材では、20件から10件に減りました。

次に、D(同じ大きな版の中での更新)を試しました。版の数字の意味は、npmの公式資料に、次のようにあります。「後方互換の不具合修正は3つ目の数字」「後方互換の新機能は真ん中の数字」「互換性を壊す変更は先頭の数字」を上げる、という考え方です。先頭の数字が同じなら、互換性は保たれる想定の範囲です(想定であり、保証ではありません)。

9部品を、先頭の数字を変えずに最新へ上げました。

express4.16.44.22.3
body-parser1.18.31.20.9
express-session1.15.61.19.0
lodash4.17.114.18.1
moment2.22.22.31.0
ejs2.6.12.7.4
nodemailer4.6.84.7.0
request2.88.02.88.2
sqlite34.0.44.2.0

結果は、20件から10件でした。内訳は、致命的が6件から5件、高が7件から2件、中が2件から3件、低が5件から0件です。画面と操作の確認10回は、すべて期待どおりでした。

body-parserは、GitHubの公開データベースの記載では、1.20.3より前の版に、入力の受け取りに関する指摘があり、1.20.3で直るとされています。今回、1.18.3から1.20.9へ上げたあと、body-parserの項目は一覧から消えました。公開データベースの記載と、手元の結果が一致しています。

ここで残った10件は、次の3種類でした。

ejs(画面の部品)直接、致命的大きな版替え(7.0.2)が必要
nodemailer(メール送信)直接、致命的大きな版替え(10.6.0)が必要
sqlite3(DB接続)と、その下の部品直接と間接大きな版替え(6.0.1)が必要
request(通信)直接、致命的直せる版なし
form-dataなど、requestの下の部品間接requestに連動

同じ大きな版の中の更新で、10件が解けたことが、ここでの最大の収穫です。大きな版替えより影響が小さく、作業量が少ない見込みなので、最初に手を付ける順番として、有力な候補になります。

5. 最新の大きな版へ上げれば、0件になるのか

今回は0件にならず、5件が残りました。

最後に、C(9部品すべてを最新の大きな版へ)を試しました。たとえば、expressは4.16.4から5.3.0、ejsは2.6.1から7.0.2です。

結果は、5件でした。致命的が2件、中が3件です。画面と操作の確認10回は、すべて期待どおりでした。ただし、この確認は浅いものです。応答の番号と、一覧に出る行数を見ただけで、表示の細部、権限の分け方、大量データでの動作は確かめていません。expressやejsのような土台の部品を大きく上げて、10回の呼び出しが通ったことは、「動く可能性が高い」という手がかりにとどまります。

4通りの手当てと、残った件数の比較表。Cで残った5件の内訳つき

Cで残った5件の中心は、通信の部品requestです。npmは、直せる版が無いと表示しました。この部品は、npmの登録簿で非推奨の表示が付いています。版を上げても解けないので、この部品を使っている箇所を、別の方法に置き換える必要があります。今回のアプリでrequestを使っているのは、チャット通知の送信1か所(1ファイル)でした。置き換えの作業は、今回は行っていません。

「最新へ上げれば0件になる」とは限らない、というのがこの検証で最も大きな学びでした。部品によっては、更新の道が閉ざされていて、置き換えしか道がありません。

6. 直す・様子見・置き換えの分かれ目

4通りの結果を使って、分かれ目の表を作りました。記入例は、今回のアプリの実際の部品です。

直す同じ大きな版の中で、版を上げるだけで解けるexpress、body-parser、lodash、moment、express-session版を上げて、確認の10回を流す。差分は1画面ずつ見る
様子を見る(先に確認する)解くには大きな版替えが必要。影響範囲が読めないejs、nodemailer、sqlite3使われ方を確認してから。画面の部品、メール送信、DB接続のどこに影響するか
置き換える直せる版が無い、または非推奨request使っている箇所を洗い出し、別の方法へ。1か所なら小さな作業

「様子を見る」は、何もしないという意味ではありません。大きな版替えの影響を確かめる前提の保留で、確認の期限と担当を決めます。公式のOWASP資料も、更新した部品との互換性を試験しないことを、弱点の一因に挙げています。大きく上げる前に、互換の試験が要ります。

もう1つ、深刻度だけで順番を決めないことも大切です。今回のアプリでは、致命的に分類された部品が、画面の部品(ejs)、メール送信(nodemailer)、通信(request)、道具箱(lodash)などに分かれていました。それぞれ、アプリの中で担っている役割が違います。どの部品に、利用者から入ってきた値が渡るのか。その部品が、本番で実際に呼ばれるのか。開発会社に、部品ごとに聞きます。

7. 開発会社に聞く質問と、依頼のときの書き方

報告書を受け取ったときに、発注側が聞ける質問を、記入例つきで書きます。

この件数は何日の結果か2026-11-17。ロックファイルなし日で変わるため。再現できる条件の確認
件数は部品の数か、問題の数か部品の数(20部品、うち直接9)数え方が違うと比較できない
audit fix を実行したか。実行後の件数は実行済み。20件のまま(版が固定)効いていないのに「実施済み」と書かれる例がある
同じ大きな版の中で上げた場合の件数10件影響の小さい更新の効果
大きな版替えが要る部品はどれかejs、nodemailer、sqlite3見積の単位になる
直せる版が無い部品はあるかrequest(非推奨)置き換えの作業が必要
更新後に何を確認するか画面と操作の10回。本番データでの確認は別途確認の範囲が見積に入っているか

見積の依頼では、「直す」「様子を見る」「置き換える」を、別の項目として見積もってもらうと、比べやすくなります。1つにまとめて「部品の更新一式」とされると、何にどれだけかかるのかが分かりません。費用は、確認する範囲の広さ(画面の数、試験の量)と、置き換える箇所の数で増減します。

8. 公開資料との違いと、未検証のこと

公開されている解説記事にも、npm auditの使い方があります。ある記事では、npm audit fixで直らなかった事例が紹介されていて、どの部品が古い版を呼んでいるかを調べ、ロックファイルの中の版を書き換える対処が書かれていました。別の記事では、重大度の確認から、修正の手順までが整理されています。それらの記事に対して、この記事は、4通りの手当てを同じ題材で比べ、件数と動作確認の結果を並べた点が違います。

未検証のことを書きます。

  • npm audit fix --forceそのものは動かしていません。Cは、各部品の最新版を直接指定した結果です。
  • 指摘された機能が、実際にアプリの中で使われているかは確かめていません。
  • メール送信とチャット通知の実際の動作は確かめていません。
  • 画面の見た目、権限の分け方、大量データでの速さは確かめていません。
  • requestの置き換えは行っていません。作業量は、今回は計っていません。
  • 日が変わると件数が変わるかは、実際には確かめていません。公式資料の説明(登録簿に照らす)にもとづく読み方です。
  • ほかの言語(PHPなど)の同様の道具は、この記事の範囲外です。

報告書の件数を、直す、様子を見る、置き換えるに分ける流れ

9. 受け取ったあとの最初の1日の使い方

ここまでを、受け取った直後の1日の使い方にまとめます。

1npm auditを動かし、日付つきで保存する数秒
2件数を、直接と間接、深刻度で分ける表にするのに、出力を読む時間が別に要る
3audit fixを動かし、実行後の件数を書く数秒
4同じ大きな版の中で更新し、件数を書く数秒
5画面と操作の確認を流す(10回)数秒
6残った部品を、様子を見る、置き換えるに分ける部品ごとの使われ方の確認が別に要る

所要の欄は、コマンドの実行時間だけです。報告書を読み、部品ごとの使われ方を確認し、判断する時間は含まれていません。

直す、様子を見る、置き換えるを、部品の例と一緒に並べた図

まとめ

今回の題材では、npm auditの20件は部品の数で、直接9、間接11でした。何もしなくても自動修正でも20件のままで、同じ大きな版の中の更新で10件、最新の大きな版へ上げると5件になりました。最後まで残った部品は、直せる版が無く、置き換えが必要でした。報告書を受け取ったら、「何日の結果か」「実行後の件数」「同じ版の中で上げた件数」の3つを聞くと、作業の順番が見えてきます。

見積の項目を「直す」「様子を見る」「置き換える」に分けたいときは、報告書を見ながら、一緒に分けていく進め方もあります。

よくある質問

npm auditで致命的が出ていたら、すぐ止めるべきですか。

今回の検証だけでは、止めるべきかは決められません。npm auditは、部品の版に既知の指摘があることを示すもので、そのアプリの中で指摘された機能が実際に使われているかまでは示しません。今回の題材では、致命的は6件でしたが、どの部品がアプリの中で何をしているかを分けてから、直す順番を決めました。止めるかどうかは、そのアプリを使っている業務と、指摘された部品の使われ方を、開発会社と一緒に確認して決めます。

npm audit fix を打てば直りますか。

今回の題材では、何も直りませんでした。20件のままで、直接使う9部品の版も1つも動きませんでした。部品の版が1つに固定されていたためと考えられますが、固定を外した場合の結果は別に試していません。公式資料では、依存の範囲を変える必要がある場合は --force が要ると説明されています。

最新の版へ全部上げれば、件数は0になりますか。

今回の題材では、5件が残りました。残った中に、直接使っている通信の部品が含まれ、npmは直せる版が無いと表示しました。その部品はすでに非推奨の表示が付いていたので、版を上げるのではなく、別の方法への置き換えが必要になります。置き換えの作業自体は、今回は試していません。

npm auditを自社で動かしてもよいですか。

公式資料では、npm auditは、プロジェクトの依存の一覧を、既定の登録簿へ送って、既知の脆弱性の報告を受け取るものと説明されています。依存の一覧が社外に出る点を、社内の取り決めに照らして確認してから動かします。結果は、動かした日の登録簿の内容にもとづくため、結果には日付を付けて残します。

参照元・出典

FREE CONSULTATION

「うちの場合はどうか」から

記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。

運営:株式会社miitaso(会社概要)

RELATED