よくあるエラーと対処法
「エラーが出て進めない！」というときはここを見てください。
慌てず、一つずつ確認しましょう。大丈夫です。
Node.js / npm 系
node: command not found / npm: command not found
原因: Node.js がインストールされていない、または nvm の設定が完了していない。
対処法:
# nvm でインストールされているか確認
nvm list
# v22 をインストール・使用
nvm install 22
nvm use 22
# 確認
node -v # v22.x.x が表示されれば OKWindows の場合は、新しいターミナルを開いてから再試行する。
npm install で EACCES: permission denied エラー
原因: Mac で権限エラー。sudo で Node.js をインストールしている場合に起きやすい。
対処法: nvm 経由で Node.js を再インストールする。
# まず nvm 経由で Node.js を管理し直す
nvm install 22
nvm use 22
nvm alias default 22Next.js 系
Error: Cannot find module '...'
原因: npm install が済んでいない、またはパッケージが足りない。
対処法:
npm installそれでも出る場合は、node_modules を削除して再インストール。
# Windows（PowerShell）
Remove-Item -Recurse -Force node_modules
npm install
# Mac
rm -rf node_modules
npm installError: Invalid <Link> with <a> child
原因: Next.js 13以降は <Link> の中に <a> を書かない。
// ❌ 古い書き方
<Link href="/about"><a>About</a></Link>
// ✅ 正しい書き方
<Link href="/about">About</Link>useClient エラー / useState is not a function 系
原因: App Router で useState などのクライアントフックをサーバーコンポーネントで使っている。
対処法: ファイルの先頭に 'use client' を追加する。
'use client' // ← ファイルの1行目に追加
import { useState } from 'react'CORS policy エラー
原因: 別オリジンのAPIにアクセスしようとして、CORSでブロックされている。
対処法:
→ HTTPSとCORSを理解する を参照。
自分で作ったAPIなら、サーバー側でCORSヘッダーを設定する。
Prisma 系
Error: Can't reach database server
原因: DATABASE_URL が間違っている、またはネットワーク接続の問題。
対処法:
.envのDATABASE_URLを確認する（コピーミス・パスワードのtypoが多い）- Supabase ダッシュボードで接続文字列を再コピーする
- パスワードに特殊文字（
@#!など）が含まれる場合は URL エンコードが必要
# @ が含まれる場合は %40 に置き換える
# 例: パスワードが "pass@word" の場合
DATABASE_URL=postgresql://postgres.xxx:pass%40word@host.../postgresPrismaClientInitializationError
原因: Prisma Client が生成されていない。
対処法:
npx prisma generateMigration failed
原因: スキーマの変更がDBの現状と矛盾している。
対処法: 開発中は思い切ってDBをリセットする（データが消えることに注意）。
npx prisma migrate resetGit 系
fatal: not a git repository
原因: git init をしていないフォルダで git コマンドを実行した。
対処法:
git initerror: failed to push some refs to ...
原因: ローカルより GitHub の方が新しいコミットがある（他の端末からプッシュした等）。
対処法:
git pull origin main
# コンフリクトがあれば解消してから
git push origin maingit push で認証エラー
原因: パスワード認証は廃止されており、Personal Access Token が必要。
対処法:
- GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
- 「Generate new token (classic)」をクリック
- スコープで
repoにチェックを入れてトークンを生成 git push時にパスワードとして生成したトークンを入力する
Flutter 系
flutter: command not found
原因: Flutter SDK の bin フォルダが PATH に追加されていない。
対処法:
→ なぜFlutterを使うのか のセットアップ手順を再確認する。
Gradle build failed (Android)
原因: Android Studio・SDK・JDK のバージョン不一致など、様々な原因がある。
対処法:
flutter clean
flutter pub get
flutter runそれでも解決しない場合はエラーメッセージをAIに貼り付けて解決策を聞く。
CocoaPods not installed (Mac/iOS)
原因: iOS ビルドに必要な CocoaPods がインストールされていない。
対処法:
sudo gem install cocoapods
cd ios
pod install困ったときの鉄則
- エラーメッセージをよく読む — 最初の1〜2行に原因が書いてあることが多い
- AIに貼り付ける — エラーメッセージをそのままAIに貼り付けて「どういう意味ですか？どう直せばいいですか？」と聞く
- メンターに相談 — 30分悩んでも解決しなければメンターに連絡する。遠慮せずに！