開発会社選び・協業読了約16分

引き継いだWebアプリが手元で動くまでの詰まりと、聞く相手の表

引き継いだアプリが動くまでの詰まり5つと、聞く相手を実際に動かして表にしました。

記事の概要図

別の会社が作ったWebアプリを引き継ぐことになり、ソースコードの圧縮ファイルを受け取りました。「動くかどうか、まず手元で試してほしい」と頼まれた開発会社から、数日後に連絡が来ます。部品が足りない、データベースが無い、設定が合わない。そう聞いても、何が足りないのか、誰に頼めば解けるのかが、発注した側には分かりません。サーバーの情報はあるが、中身を取り出してよいのかも分かりません。こんなことはないでしょうか。

この記事では、前回の記事と同じダミーのWebアプリ(見積依頼を記録する小さな業務アプリ)を、圧縮ファイルを開いただけの状態から、実際に手元で動かしました。出たエラーをそのまま画面で載せ、詰まった所と、誰に何を聞けば解けるのかを表にしています。確かめたのは2026年11月17日の1回分で、今回の題材(Node.js、SQLite、画面5枚)に限った結果です。

この記事で分かること

結論から言うと、今回の題材では詰まりが5つ順に出て、聞く相手は旧サーバーの管理者・作った側・別の開発会社の3つに分けられました。いちばん気づきにくかったのは、エラーが出ないまま一覧が空になる詰まりです。

  • 受け取った圧縮ファイルを起動するまでに、実際に出た5つの詰まりと、それぞれのエラーの文言
  • 「画面が出たのに中身が空」という、エラーが出ない詰まりの実例
  • 詰まりごとに、旧サーバーの管理者・作った側・別の開発会社のどこへ何を聞くかの表

1. 検証したこと

題材は、ダミーのアプリです。Node.jsで書かれた見積依頼のメモ帳で、ファイル20件、設定とダミーのパスワードが設定ファイル1つに直書きされ、説明書もテストもDBの作り方の記録もありません。部品は2017年から2018年に公開された版で固定されています。実在の会社の資料ではありません。

環境は、macOS 27.2.1、Node.js v22.22.0、npm 11.3.0です。圧縮ファイルは新しい空のフォルダに開き、原本は触っていません。部品の導入はnpm install --ignore-scriptsで行いました。この指定は、部品が持っている導入時のスクリプトを動かさないものです(npmの公式資料では、ignore-scriptsが真のとき、package.jsonに書かれたスクリプトを動かさないと説明されています)。古いDB接続部品は導入時に外から実行ファイルを取るため、それを避ける目的です。

手順は、起動を試し、出たエラーを読み、1つ解いて、また起動する、の繰り返しです。解いたのは4回(部品の導入、接続部分の差し替え、DBの場所の変更、表の作成)でした。

かかった時間は、コマンドの実行時間で測りました。部品の導入が3秒(166個の部品)、各回の起動と確認は数秒です。ただし、エラーを読んで、差し替えのコードやDBの表の作り方を書く時間は、計っていません。作った本人が検証しているため、初めて中身を見る人よりはるかに速く進みます。実際の案件の時間の目安にはなりません。

うまくいかなかった所は、2つあります。1つは、DB接続部品が動かない状態で止まり、元の部品を動かす所までは進められなかったことです。もう1つは、検証用のサーバーを立てる番号(ポート)に、最初は3000番を使い、あとで別のプログラムがすでに使っている番号だと気づいたことです。3917番に替えて、確認をやり直しました。結果は同じでした。手元で動かすときに「その番号が空いているか」が詰まりになることもある、という実例です。

詰まりが出た順番。部品が無い、接続部品が動かない、DBの場所が無い、表が無い、通知の行き先が不明

2. 試す1 部品が入っていない

圧縮ファイルを開いて、そのまま起動の命令を打ちました。

起動を試した画面。部品が見つからないエラー、導入後の接続部品が見つからないエラー

1回目の出力はCannot find module 'express'でした。「expressという部品が見つからない」という意味です。圧縮ファイルに部品の本体(node_modulesというフォルダ)が入っていなかったためです。部品の本体は容量が大きく、通常は受け渡しから外します。部品の一覧(package.json)から入れ直すのが普通の手順です。

ここでの詰まりの原因は「同梱されていない」だけで、誰かに聞く必要はありません。ただし、入れ直す部品の版には注意が要ります。npmの公式資料によると、ロックファイル(package-lock.json)は、あとの導入で同じ部品の木を作れるようにするためのファイルです。今回の圧縮ファイルにはロックファイルがありません。直接使う9つの部品は版が固定されていたので同じ版が入りますが、その下で使われる部品は、今日入れ直した結果です。導入結果の166個のうち、直接の9個以外の157個は、今日の登録簿から決まった部品です。

3. DB接続の部品が動かないとき、どう進めればよいのか

動いていた頃のNodeの版に合わせるか、接続部品の版を上げるか、DBに触る数行を書き換えるかの3つで、今回は3つ目をコピーの上で行いました。

部品を入れ直して、もう一度起動しました。2回目のエラーは次のとおりです。

Cannot find module '…/node_modules/sqlite3/lib/binding/node-v127-darwin-arm64/node_sqlite3.node'

読み方を説明します。sqlite3はDBに接続する部品です。ファイル名のnode_sqlite3.nodeは、この部品が使う、機械語に組み立てられた部分です。名前の途中のnode-v127は、Node.jsの内部の版を表す番号で、このMacのNode v22.22.0に対応するものです。つまり「このNodeの版に合わせて組み立てたものが無い」という意味です。

この部品は、導入の最後に、組み立てたもの(または外から取ってきたもの)を置く仕組みを持っています。今回は--ignore-scriptsでその段階を動かさなかったため、組み立てたものが無いのは当然の結果です。では、普通に導入すれば動くのかというと、そこは未検証です。2018年11月公開の版を、2026年の版のNodeで組み立てられるかは、今回の検証の範囲外です。

実際の案件で、この詰まりに当たったときの選択肢は3つあります。

当時のNodeを使う動いていた頃の版のNodeを用意して起動する当時の版が分かっていて、短期間だけ動かせればよいとき
接続部品の版を上げるDB接続部品を新しい版に替える部品の差し替えで済むとき(動作確認が必要)
接続の部分を書き換えるDBに触る数行を別の方法に替える小さなアプリで、DBに触る場所が少ないとき

今回は3つ目を、コピーの上だけで行いました。DBに触る部分は4行のファイルに集まっていたので、Node.jsに内蔵のSQLite機能(node:sqlite)を使う形に替えました。公式資料では、この機能は確認時点で「Stability: 1.2 - Release candidate」と表示されています。実行時にも、実験的機能だという警告が出ました。検証には使えますが、本番に使う判断は別の話です。元のファイルには手を入れていません。

誰に聞くかは、ここで初めて必要になります。「動いていた頃のNodeの版」は、旧サーバーでnode -vを打てば1行で分かります。作った側が覚えていればそれでも構いません。聞く先は、旧サーバーの管理者です。

4. DBの写しが無いまま動かすと、どう見えるのか

DBの場所が無ければ起動時にエラーが出ますが、空のDBがあるだけだと、エラーが出ないまま空の一覧が出ます。

差し替えたあとの3回目のエラーは、unable to open database fileでした。設定ファイルに、DBの場所が/var/www/html/mitsumori/data/app.dbと書かれていて、このMacにはその場所が無いためです。この場所は、旧サーバーの中のものです。

そこで、設定ファイルのコピーのDBの場所を、検証用のフォルダの中に変えました。すると今度は、エラーなしに起動しました。ここが最も危ない場面です。

表が1つも無い空のDBでログインした直後の一覧画面。エラーは出ず、見出しだけの空の表が出る

画面は正常に出ています。ログインもできます。一覧が空なだけです。しかし裏では、「requestsという表が存在しない」という問い合わせの失敗が起きています。アプリのコードは、問い合わせの失敗を受け取っても、結果が空なら空の一覧を出す作りになっていました。つまり、エラーを握りつぶして、空の一覧を出していたのです。ログにも何も出ません。

実際の案件でも、DBの写しを受け取らずに動かすと、同じ見え方になります。「画面は開いたが、データが1件も出ない」。このとき、アプリの不具合なのか、データが無いだけなのかが、画面からは区別できません。

聞く先は、旧サーバーの契約名義人か、ホスティング会社です。聞くことは、DBファイルの写しを出してもらえるか、です。取り出せないという返事も、そのまま書面で受け取ります。

5. DBの写しが無いとき、表の構造は推定できるのか

コード中のSQL文から表と列の名前までは推定できますが、型や制約は決まりません。

DBの写しが無いとき、コードの中のSQL文から、表の構造を推定できます。今回のコードには、SELECT、INSERT、UPDATEの文が8本ありました。そこから、依頼(requests)と取引先(customers)の2つの表と、列(番号、件名、本文、状態、受付日時など)が読み取れます。推定した表の作り方を、schema_推定.sqlというファイルに2行で書き出しました。

推定には限界があります。列の型(文字か数字か)、空にしてよいか、重複を許すかは、コードからは決まりません。今回は、日付を文字として保存する形にして、動作に支障のない範囲で作りました。実際には、本番のDBの写しが手に入れば、その構造を使うのが正解です。

推定した表が、コードの使い方と合っているかは、次の3点で点検できます。コードに出てくる列名がすべて表にあること、登録の文(INSERT)で入れる列の数と値の数が合うこと、一覧の検索で使う列(件名)が表にあること、です。この3点は、動かす前に、コードを読むだけでも点検できます。点検で落ちた場合は、表の側ではなく、コードの側の不具合を疑います。

表を作り、ダミーの依頼3件、取引先3件を入れてから、画面とボタンを順に呼びました。呼び出しは10回で、結果は次のとおりです。

全画面とボタンを順に呼んだ結果。ログイン、一覧、登録、状態変更、催促メールの送信ボタンまで応答が返る

ログイン画面を開く画面が出る(200)200
ログインを送る転送される(302)302
一覧、登録画面、詳細、取引先画面が出る(200)すべて200
存在しない番号の詳細見つからない(404)404
依頼の登録、状態の変更、催促メール転送される(302)すべて302

呼び出し10回は、すべて期待どおりの応答でした。DBの中身も、依頼を1件登録したあとに4件になり、状態の変更も反映されました。

表を作りダミーを入れた後の一覧画面。依頼3件が取引先名と状態つきで並ぶ

ここで言えるのは、「画面とボタンが応答を返す」までです。表示の細部、権限の分け方、大量のデータでの速さは確かめていません。

6. 試す5 通知は動いたのか分からない

最後の呼び出し(催促メールのボタン)も、302が返りました。ところが、メールが実際に出たのか、出ようとして失敗したのかは、アプリのログからは分かりませんでした。検証後のログに残っていたのは、起動の知らせと、実験的機能だという警告だけです。

この題材では、メール送信とチャット通知の宛先は、存在しない名前(ダミー)にしてあります。呼び出しの失敗を受け取るコードが空だったため、失敗しても何も残りません。つまり、ボタンを押して302が返っても、通知が相手に届いたことの証拠にはなりません。通知が届いたかは、この検証では確かめていません。

逆の危険もあります。本番の設定値(メールの送信設定、チャットの鍵)が入った設定ファイルを、そのまま使って手元で動かすと、ボタン1つで、本番の送信設定を使って実際のお客様に通知が出る可能性があります。手元で動かす前に、通知の設定をダミーか空にして起動する。これを、動かす手順の最初に入れておくと安全です。

画面が出ることと、データが正しいこと、通知が届くことの違い

7. 詰まったとき、誰に何を聞けばよいのか

旧サーバーの管理者にはNodeの版とDBの写しを、作った側には表の作り方と設定の意味を、別の開発会社には推定や差し替えをしてよいかの判断を聞きます。

ここまでの詰まりを、表にします。「誰に聞くか」の欄は、今回の題材で実際に必要になった順で書いています。

1部品が見つからない部品の本体が同梱されていない聞く必要なし入れ直す。ロックファイルが無いため、下の部品の版は今日のものになる点を記録する
2DB接続の部品が見つからない導入時の組み立てを動かしていない。Nodeの版も違う旧サーバーの管理者動いていたNodeの版(node -vの出力)を1行
3DBファイルを開けないDBの場所が旧サーバーの中を指している旧サーバーの契約名義人、ホスティング会社DBの写しを出してもらえるか。出せないなら、その旨を書面で
4一覧が空になる(エラー無し)表が存在しない。失敗を空の結果として扱う作り作った側、または別の開発会社表の作り方の記録。無ければ推定で作ってよいか
5通知の成否が分からない失敗を受け取るコードが空通知先サービスの契約者通知の設定が今も有効か。手元の試験で出さない方法
6(検証で追加)番号がすでに使われていた別のプログラムが同じ番号を使用聞く必要なし起動の番号を替える。設定が直書きなので、設定ファイルを直す

聞く相手を3種類に分けると、整理しやすくなります。旧サーバーの管理者(Nodeの版、DBの写し)、作った側(表の作り方、設定の意味)、別の開発会社(推定してよいか、差し替えてよいかの判断)です。

詰まりごとに聞く相手を3つに分けた図。旧サーバーの管理者、作った側、別の開発会社

作った側と連絡がつかない場合は、聞く相手が別の開発会社に集まります。そのとき、別の開発会社が「推定でよいか」を決めるには、本番のDBの写しが無い状態で作った表であることを、発注側が理解しておく必要があります。推定した表で動いた結果は、本番のデータでの動作を保証しません。

8. 動かすために要った資料の一覧

実際に動かすのに要った順で、渡す資料を並べます。

ソースコードの圧縮ファイルすべて作った側に最新版を頼む
動いていたNodeと部品の版試す2旧サーバーで確認してもらう
DBの写し試す3、試す4構造の推定で代用(本番データの確認は不可)
通知先の契約情報試す5通知を無効にして試験する
設定ファイルの本番値本番に近い確認の段階ダミーで動かし、本番値は渡さない

設定ファイルの本番値は、診断や手元の動作確認の段階では渡す必要がありません。今回、設定値はすべてダミーで足りました。

9. 確認票と握りつぶしの見つけ方

今回の詰まりから逆算して、手元で動かす前に埋める確認票を作りました。記入例は今回の題材のものです。

原本の圧縮ファイルの指紋を控えたか控えた(ハッシュの先頭を記録)作業中に原本を壊していないことを後で示す
作業用のコピーで動かすかコピーで実施。原本は触らない設定やコードの書き換えを原本に残さない
通知(メール、チャット)の設定を無効にしたかダミーの宛先に替えた本番のお客様に出さない
起動の番号は空いているか3000番は使用中。3917番に変更別のプログラムと衝突しない
動いていたNodeの版は分かるか不明(旧サーバーに依頼中)部品の組み立ての成否に関わる
DBは本番の写しか、推定した表か推定した表。ダミー3件結果の信頼度が変わる

もう1つ、エラーを握りつぶす作りの見つけ方も書いておきます。今回のコードには、DBの結果を受け取る場所が6つありました。それらはいずれも、エラーを受け取る入れ物(err)を持っています。ところが、そのエラーを読んで処理している箇所は、検索したところ0件でした(function (errを含む行を数えて6件、if (errを含む行を数えて0件。どちらもgrepで数えた)。エラーを受け取りながら読まない作りは、失敗しても何も出ません。開発会社に見てもらうとき、「エラーを受け取って読んでいる箇所が何件あるか」という数を1つ聞くだけで、この種の詰まりが起きやすいかが分かります。

この数え方は、検索1回で済みます。ただし、0件だからといってすぐに不具合と決めつけることはできません。呼び出し側が別の形で失敗を扱っている場合もあります。今回の題材では、実際に表が無いときに空の一覧が出たので、0件が実害につながっていました。

まとめ

今回の題材では、圧縮ファイルを手元で動かすまでに、5つの詰まりが順に出ました。うち、画面が出たあとの空の一覧が、いちばん気づきにくいものでした。起動できたかどうかではなく、データが出ているか、通知が届いたかを、別々に確かめる必要があります。聞く相手は、旧サーバーの管理者、作った側、別の開発会社の3つに分けると整理でき、旧サーバーに残っているDBの写しが、いちばん早く手に入れておきたい資料でした。

詰まりの表を作る段階から手伝ってほしいときは、受け取ったままの圧縮ファイルを見ながら、一緒に表を埋める進め方もあります。

よくある質問

手元で動かしたとき、本番のお客様へメールが出てしまうことはありますか。

本番の設定値(メールの送信設定、チャット通知の鍵)を入れたまま、通知を出すボタンや処理を動かすと、実際に出る可能性があります。今回の題材は宛先がダミーの値だったため、外へは出ていません。実際の案件では、手元で動かす前に通知の設定をダミーか空にしてから起動します。

データベースが無いまま動かしたら、エラーは出ますか。

今回の題材では、DBの場所が見つからないとき起動時にエラーが出ました。ところが、空のDBファイルがあって表が1つも無いときは、エラーが出ず、一覧が空の表として表示されました。画面が出たから動いている、とは言えない例です。

部品の導入スクリプトを動かさなかったのはなぜですか。

古い版のDB接続部品は、導入時に外から実行ファイルを取ってくるか、手元で組み立てる仕組みでした。この検証では外からの実行ファイルを取らない決まりにしたため、導入スクリプトを動かさずに入れました。結果として接続部品が動かない状態で止まり、その実際の組み立ての成否は未検証です。

仮に差し替えて動かした結果は、本物の動作と同じと言えますか。

同じとは言えません。今回はDB接続の部分だけを別の仕組み(Nodeに内蔵のSQLite)に替えたコピーで確かめました。画面の応答と登録・状態変更の確認には使えますが、本来の接続部品の動きは確かめていません。

参照元・出典

FREE CONSULTATION

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

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

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

RELATED