付録
詰まったとき辞書
エラー文の意味と、その直し方
エラーの文面は、たいてい英語です。
でも、意味が分かってしまえば怖くありません。
ここに出てくるものは、この教科書を作る過程で実際に僕が踏んだものが中心です。
この付録の使い方
- 詰まったら、まず画面に出ている英語をこのページで探す
- 無ければ、そのエラー文をそのままClaude Codeに貼って聞く
- 「何をしていて、何が起きて、何を期待していたか」を添えると、解決が早い
まず覚えてほしい、たった1つのこと
エラーが出たときにやるべきことは、その文面をコピーして、そのままAIに貼ることです。
要約しないでください。
省略もしないでください。
人間には意味不明な英語でも、AIには十分な手がかりです。
詰まったときの万能プロンプト
次のエラーが出ました。原因を調べて、直してください。 （ここにエラー文をそのまま貼る） ・私がやろうとしていたこと：（例：画像をR2に保存しようとした） ・期待していた結果：（例：管理画面に画像が増える） ・実際に起きたこと：（例：成功と出るのに増えていない） 直したあと、なぜそうなっていたのかを、専門用語を使わずに説明してください。
公開・ログインまわり
エラー文と対処
- Not logged in / Authentication error
- Cloudflareへのログインが切れています。
ログインし直せば直ります。
しばらく使っていないと期限が切れることがあります。 - A worker with this name already exists
- 同じ名前のものが、すでにあなたのアカウントにあります。
名前を変えるか、既存のものを上書きするかを選びます。 - command not found: node
- Node.jsが入っていません。
エラーというより「まだ無い」という報告です。
第4章に戻って入れてください。 - 404 Not Found（公開したのに）
- 公開したフォルダの中に
index.htmlが無いか、フォルダの指定がずれています。
R2まわり
エラー文と対処
- Resource location: local
- エラーではないのに、一番厄介なものです。
本物のR2ではなく、パソコンの中の練習用の場所に保存されています。
「本物のR2（リモート）に保存してください」と伝え直してください。 - TypeError: env.BUCKET is undefined
- Workerに「この倉庫を使っていい」という権限（binding）が渡っていません。
設定ファイルを確認し、直したあとに公開し直す必要があります。 - A bucket with this name already exists
- そのバケット名は使用済みです。
別の名前にして、設定ファイル側の名前も揃えてください。 - The specified key does not exist
- そのキーのファイルがありません。
キーは1文字違うだけで別物です。
一覧を出して見比べるのが確実です。
表示まわり
症状と対処
- 画像が表示されず、ダウンロードが始まる
- Content-Type（種類の札）が付いていません。
保存時か、返すときのどちらかが抜けています。 - 直したのに、古い内容が表示され続ける
- キャッシュです。
強制的に再読み込みするか、シークレットウィンドウで確認してください。
それでも古い場合は、公開そのものができていない可能性があります。 - 日本語が「?」や記号に化ける
- 文字の種類の指定が抜けています。
「文字コードの指定（UTF-8）を入れてください」と伝えれば直ります。 - パソコンでは見えるのに、スマホで見えない
- localhostのURLを見ている可能性があります。
localhostは自分のパソコンの中だけのアドレスです。
公開後のURLで確認してください。
どうしても分からないとき
3回試して直らなかったら、いったん手を止めて、こう頼んでください。
行き詰まったときのプロンプト
同じ問題が3回直りません。いったん切り分けたいです。 いまの状態を調べて、次を教えてください。 1. どこまでは正しく動いていて、どこから動いていないのか 2. 原因の候補を、可能性の高い順に3つ 3. それぞれを確かめるための、一番簡単な方法 まだ直さなくていいので、切り分けだけ先にお願いします。
直そうとする前に切り分ける。
これは人間のエンジニアがやっていることと同じです。
急がば回れが、結局は一番速いです。