SBクリエイティブ

その他

第10章 バックエンドのVercelデプロイが失敗する場合の対処法

2026.10.08
対象書籍
つくりながら理解する Webアプリ開発入門

2026年10月時点で、第10章「バックエンド用プロジェクトのセットアップ」(p.364)の手順でVercelにデプロイすると、次のエラーでビルドが失敗することがあります。
Error: error TS2688: Cannot find type definition file for ‘node’. The file is in the program because: Entry point of type library ‘node’ specified in compilerOptions

(原因)
本書ではTypeScriptをインストールするときにバージョンを指定していません。そのため執筆後に正式リリースされたTypeScript 7系(例:v7.0.2)が入ります。TypeScript 7系には大きな変更が含まれていて、本書のサンプルの設定ではビルドが通らなくなることがあります。

(対処法)
backendディレクトリで以下を実行し、TypeScriptを本書の検証時と同じ5系にそろえてください。
cd ~/Projects/kakeibo-app/backend
npm install -D typescript@^5.8.3

実行後、package.jsonのdevDependenciesが”typescript”: “^5.8.3″になっていることを確認します。package.jsonとpackage-lock.jsonをコミットしてプッシュすると、Vercelで再デプロイが始まります(始まらない場合は、Vercelのダッシュボードから[Redeploy]を実行してください)。

この記事をシェアする