よくある原因
「一部だけ古い」という報告の多くはブラウザのキャッシュが部分的に残っているケースです。特定の画像やCSS、フォントが古いキャッシュから読み込まれ、HTMLは新しいのに見た目が変わらない状態になります。依頼メッセージでは最初に「ハードリフレッシュ（Ctrl+Shift+R / Cmd+Shift+R）を試してください」と伝えると手間なく解決することが多いです。
もう一つの原因として、相手のネットワーク内にプロキシサーバーがあり、そこがキャッシュを保持しているケースもあります。この場合はハードリフレッシュでは解決できません。「スマートフォンのモバイル回線で開いて同じ症状か確認してください」と依頼すると、プロキシが原因かどうかを素早く切り分けられます。
- 相手がログインなしで開ける状態か確認する
- PCとスマホで最低1回ずつ表示を確認する
- 内部情報・個人情報・不要な外部送信が残っていないか見る
- レビュー期限と修正時の差し替え方を決めておく
自分側で確認すること
相手に連絡する前に、自分のCDNのキャッシュが正しくパージされているかを確認してください。`curl -I https://example.com/page.html`でレスポンスヘッダーの`Last-Modified`を確認し、差し替え後の日時になっているかをチェックします。古い日時なら相手への依頼の前にまずキャッシュパージが必要です。
また、差し替えたHTMLが正しいバージョンかを確認するために、ファイルの最初の数行にバージョンコメント（`<!-- v1.2 2024-01-15 -->`など）を埋め込む習慣をつけてください。相手にページのソースを右クリックで表示してもらい、バージョンコメントを確認するよう依頼すると、確実にどちらのファイルが配信されているかを判断できます。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
相手側で確認すること
確認依頼の文面には具体的な操作ステップを3つ以内に絞って伝えると相手が行動しやすくなります。たとえば「①Ctrl+Shift+Rで更新 ②それでも古ければ別のブラウザで開く ③それでも変わらなければスクリーンショットを送ってください」という形が実用的です。
相手が「どこが古いのか」を把握するために、スクリーンショットを撮ってもらうよう最初の依頼に含めておきましょう。どの部分が古い表示なのかを画像で確認できれば、該当リソースのキャッシュだけを狙ってパージできるため対処が速くなります。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
再発防止の運用
差し替え後の確認依頼メッセージは毎回一から書くのではなく、状況別のテンプレートを用意してください。「ハードリフレッシュ確認依頼版」「別ブラウザ確認依頼版」「スクリーンショット収集版」の3パターンを用意しておくと、症状に応じて素早く送れます。
差し替え作業を定例化しているプロジェクトでは、差し替え完了の通知メッセージ自体に「古い表示が残っている場合の確認手順」を最初から含めておくのも効果的です。問題が起きる前に手順を共有しておくことで、相手からの問い合わせが入ってからの対応コストを大幅に下げられます。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
よくある質問
「一部だけ古い」という曖昧な報告を受けたとき、最初に何を聞けばよいですか？
「古い表示になっている部分のスクリーンショットを送ってください」と依頼するのが最優先です。具体的に何が変わっていないかを把握しないと原因の特定ができません。
ハードリフレッシュを依頼したのに「わからない」と言われた場合の対応は？
Chromeなら「アドレスバーにURLを貼り付けてEnterを押すだけ」でもキャッシュを避けられる場合があります。さらに「Chromeの右上メニュー→設定→プライバシーとセキュリティ→閲覧履歴データを削除」の手順を日本語で案内してください。
相手の確認作業が完了したかどうかを効率よく把握する方法は？
確認依頼メッセージの末尾に「確認できたら『完了しました』と一言返信ください」とひと言添えるだけで、作業が終わったかどうかがすぐ分かります。曖昧な返信を受け取った場合は「新しい表示になっていましたか？」とYes/Noで答えられる形で再確認します。