不具合は、操作と結果を並べて調べます。公開した版、保存データ、費用を別々に管理し、小さな道具を使い続けるための手順を作ります。
この回は、しくみを読むことと、実際の結果を確かめる練習を組み合わせます。付属見本はブラウザーだけで保存する一人用の版です。アカウント・データベース・共有は拡張課題として扱います。
症状を絞り、記録から原因を探す
昨日は使えた読書メモで、今日は保存ボタンを押しても一覧が増えない。こんなときは、機能を作り直す前に、どの操作がどこで止まったのかを見ます。開ける、入力できる、保存を押せる、結果が出る、再読み込み後も残る。この順に試すと、「使えない」という大きな症状を小さくできます。
確認した時刻とURL、入力した練習データ、期待した結果、実際に見えた結果を残します。同じ題名でも、一覧の並び順が変わったために見つからない場合があります。保存されなかったのか、保存された一件が見えないのかを分けるだけで、AIへ頼む調査の範囲が変わります。
エラーの説明が出ていたら、その文章を正確に控えます。分からない用語はそのまま残し、まず何を指すのか尋ねます。番号やファイル名を、覚えやすい言葉へ勝手に置き換えると手掛かりが減ります。一方、記録の本文や秘密のキーまで丸ごと貼る必要はありません。練習データで再現できるかを先に試します。
症状から、調べる場所を選ぶ
入力と実際の結果をそろえ、処理が止まった場所を確認してから、原因の候補と修正へ進みます。記録した時刻とURLも照合に使います。
- 症状を再現
- 期待値と実際
- 処理の場所とログ
- 原因の候補
- 小さい修正
- 再確認
- ログの有無だけで、失敗がなかったとは判断しません。
- メモの本文や秘密の値を、調査用の記録へ無条件に含めません。
ログは、処理が進んだ場所や失敗を調べるための記録です。Cloudflare Workersの公式資料では、要求や応答に関連する記録と、プログラムが出した独自の記録を確認できます。資料 S22 ただし、一人用のブラウザー保存で起きた失敗が、公開先のサーバーに必ず記録されるわけではありません。処理が動いた場所を確かめます。
ブラウザーの開発者ツールや、公開先の管理画面には、詳しい結果が出ることがあります。AIへ操作を頼む前に、「このエラーを読むための場所を説明し、まだ設定を変えないでください」と伝えます。原因の調査と、設定の変更を分ければ、調べている途中に症状そのものが変わることを減らせます。
原因の候補は、証拠と一緒に受け取ります。「通信の問題だと思います」だけなら、まだ候補です。「要求が送られ、この時刻に保存先から拒否が返った」なら、次に調べる場所を選べます。ログインの期限が切れた、公開用の接続先が違う、入力の制限で止まった、といった候補を、見つかった結果から絞ります。
修正を頼むときは、変えてよい範囲を一つにします。保存の失敗を直す仕事へ、画面の全面改修や道具の一括更新を混ぜると、改善した理由を追いにくくなります。直した差分を説明してもらい、最初に失敗した入力を同じ手順で試します。次に正常な一件も確かめ、別の操作まで止まっていないか見ます。
調査を終えたら、症状、原因、直した箇所、確認した例を短く残します。次に似た不具合が出たとき、その記録が入口になります。原因が分からなければ、分かった操作と、まだ確かめられない操作を分けて書きます。無理に理由を埋めず、使える証拠を残すことも、不具合を扱う大切な仕事です。
保存の失敗を調べる依頼
この練習用URLで、題名「練習の本 A」を保存しても一覧が増えません。
期待する結果と、実際の表示を添付しました。
まず再現方法とログを調べ、原因の候補に根拠を添えてください。
設定の変更や一括更新はせず、直す箇所を絞って提案してください。
手を動かす順番
- URL・時刻・入力・結果をそろえる
- どこで動く処理かを確認し、その場所の記録を見る
- 小さい修正の後に同じ操作を再確認する
版とデータを戻し、費用を見続ける
新しい版を公開した後で問題が出たら、直前の使えていた版へ戻す選択があります。ロールバックと呼ばれる操作です。戻す前に、どの版が使えていたのか、今の保存データをその版でも扱えるのかを確かめます。前の画面へ戻ることと、消した記録が戻ることは、同じ操作ではありません。
Cloudflare Workersには、以前の版へ戻す仕組みがありますが、紐付くリソースや変更内容によって制約があります。資料 S20 他の公開サービスを使う場合も、そのサービスの案内で確認します。過去の版があるから必ず戻れる、と決めつけず、版の識別番号と戻すための条件を記録しておきます。
データには、別の備えが必要です。一人用のブラウザー保存は、そのブラウザーで使うための保存であり、別の場所にある予備のコピーではありません。資料 S31 大切な読書記録を入れる前に、書き出す方法を用意するか、別の場所へ記録を残します。プライベートブラウズの終了後も残ることは期待しないでください。
戻す対象を三つに分ける
公開したプログラムの版、保存したメモ、添付ファイルには、それぞれの戻し方があります。費用の確認も、利用するサービスごとに続けます。
データベースへ進んだ場合は、バックアップの対象を調べます。Supabaseの公式資料では、データベースのバックアップにStorage APIのファイル本体は含まれません。資料 S21 後から表紙画像を保存する機能を加えたなら、文字のメモと添付画像の復旧方法を分けて確認します。バックアップという名前だけで、すべてが戻るとは扱いません。
復元は、練習用の別環境で試します。コピーが存在することと、それを開いて元の件数や内容を得られることには差があります。いつの時点へ戻せるか、戻した後に追加した記録をどう扱うかも決めます。復元の確認中に本番の記録を上書きしないよう、作業する保存先の名前を先に照合します。
費用は、利用する道具ごとに項目を分けます。公開先、保存先、ドメイン、追加のAI処理などです。単価を暗記するより、何が増えると利用量が増えるかを理解します。Cloudflare Workersの料金資料には、要求数とCPU処理時間が課金の項目として示されています。資料 S23 自分のアプリが使う項目を管理画面で確認します。
利用量に上限や通知を設定できる場合は、その範囲を調べます。Workersの呼出しごとのCPU上限は、処理が走り続けることへの備えになりますが、アカウント全体の月額費用の上限ではありません。資料 S23 外部の保存先やAI処理に別の費用があれば、それらも合わせて見る必要があります。
使い続ける手順は、短くて構いません。定期的に一件を登録し、公開先のエラーと利用量を見て、バックアップから読めるかを確かめます。道具を更新するときは、変更内容を読み、確認用の版で先に試します。一度作った完成品を放置するより、少数の確認を続けることで、小さなアプリを安心して育てられます。
小さな運用メモ
公開した版: 識別番号と公開した日を残す。
戻す方法: 対象の版と、保存先との互換性を確認する。
予備のコピー: 対象、保存した日、実際に読めたかを記録する。
費用: 公開先と保存先の利用量、通知、上限の効く範囲を見る。
手を動かす順番
- 公開した版と、戻す候補の版を記録する
- 練習用の保存先で復元を確かめる
- 利用量と、上限が効く対象を確認する
演習：不具合の連絡と、戻す手順を作る
練習用の一件を題材に、AIへ渡す再現メモと、復旧の手順を一枚へまとめます。秘密の設定値や、実在する他の人の記録は含めません。
- URL、操作、期待値、実際の結果を四行で書く。
- プログラムの版とメモのデータについて、別々の戻し方を説明する。
- 利用するサービスごとに、費用を確認する場所を記す。
解答例を読む
再現メモには、観察できた結果を書きます。分からない原因は候補のまま残します。
コードを戻すことと、消したメモを復元することを分けます。
予備のコピーがあるだけでなく、別環境で読めたかを確認すると復旧の判断に使えます。
この回で確かめること
- URL、操作、期待値、実際の結果を四行で書く。
- プログラムの版とメモのデータについて、別々の戻し方を説明する。
- 利用するサービスごとに、費用を確認する場所を記す。