付録C: トラブルシューティング集

1. 認証・権限関連

Error: Not logged in. または Invalid API Token

• 原因: ログインセッションが切れているか、環境変数 CLOUDFLARE_API_TOKEN の権限が不足しています。
• 対処法:

  npx wrangler logout
  npx wrangler login

  APIトークンの場合は「Workers Scripts: Edit」「D1: Edit」「Pages: Edit」の権限が含まれているかダッシュボードで確認してください。

---

2. 開発サーバー関連

Port 8787 is already in use

• 原因: 前回の wrangler dev プロセスが残っているか、別プロセスがポートを使用しています。
• 対処法:

  # 別のポート番号を指定して起動
  npx wrangler dev --port 8788

---

3. D1 データベース関連

Error: no such table: xxxx

• 原因: マイグレーションが未実行です。
• 対処法:

  # ローカル開発環境の場合
  npx wrangler d1 migrations apply DB --local
  
  # 本番環境の場合
  npx wrangler d1 migrations apply DB --remote

---

4. バインディング関連

TypeError: Cannot read properties of undefined (reading 'fetch' or 'prepare')

• 原因: wrangler.jsonc のバインディング名とコード内の名前が不一致、または wrangler types が未実行です。
• 対処法: npx wrangler types を実行し、TypeScriptの型補完に従ってプロパティ名を修正してください。