Lorem Picsum
記事一覧
ガイド

Picsum Photosの障害時に使える代替サービスと復旧手順

Picsum Photosで500エラーが出たときに試したい切り分け手順。Lorem PicsumへのURL移行、固定画像の選び方、テストに使う代替画像の用意まで解説します。

picsum.photosの画像リンクが表示されない場合は、障害と決めつける前に、どのURLがどの環境で失敗するか確認しましょう。Cloudflareの画面や500番台のステータスは、リクエストを正常に処理できなかったことを示します。画面だけで原因は特定できません。納期が迫っているデモでは、原因を追う間だけでも同梱の画像に切り替えられると作業が止まりません。

Picsum Photosの画像が届かないときの確認手順

  1. ブラウザーで、失敗した画像URLを直接開きます。ネットワーク欄で302などを追い、最後の応答のステータスとContent-Typeを調べます。200でも画像としてデコードできなければ表示は失敗です。
  2. ランダム、固定ID、seedのURLを一つずつ比較します。ある写真だけ失敗するなら、IDや寸法、拡張子の誤りも候補です。ランダムのパスだけ失敗するかどうかも記録します。
  3. CIで再現する場合は、ランナーのネットワークから同じURLにGETを送ります。プロキシやDNSの違いを確認し、同じ端末で埋め込み時だけ失敗する場合はCSPやHTTPSの制限を確認します。
  4. 複数の回線で5xxが続くなら、発生時刻と確認したURLを控えます。cf-rayがあれば問い合わせ時に使えます。その間の画面は予備画像で維持します。

Picsum Photosの代替候補

Lorem Picsum(picsum.org) は、サイズとseedをパスで指定して実写写真を返します。似た名前でもpicsum.photosとは別のカタログです。旧サービスで指定したIDをそのまま移すと、別の被写体になるか画像が見つからない場合があります。元の写真と一致させる必要があるときは、利用条件を確認した上でファイルを管理してください。

Unsplash API は、キーワード検索で掲載候補を選びたい場合に適しています。組み込みにはキーとレート制限への対応が必要です。クレジット表記や画像URLの扱いも公式要件に従います。画像の内容が要らず枠の高さだけ見たいときは、Placehold の色付きプレースホルダーや、プロジェクトに同梱した小さな画像で足ります。

画像のパスを置き換えて結果を確認する

最初は一つのコンポーネントで試します。最初の行が移行前、次が同じ寸法でWebPを取得する例、最後がseedを使った例です。

https://picsum.photos/800/600
https://picsum.org/800/600.webp
https://picsum.org/seed/hero/1200/800.webp

URLの組み立てを共通関数に移し、各コンポーネントには寸法、被写体、必要ならseedを渡します。ギャラリーに異なる写真を出すときは枠ごとにseedやIDを用意します。変更後は表示の有無だけでなく、縦横比、Content-Type、スマートフォンでの切り抜きまで確認してください。最後に主配信元を無効にし、代替画像への切り替えを試します。

寸法と形式を確かめ、予備画像を用意する

Lorem Picsumの画像ジェネレーター で枠の縦横比を選び、表示先に合わせて幅と高さを指定します。公開の画像URLでは、JPEG、WebP、各辺2,000ピクセルまでの指定、グレースケール、ぼかしを使えます。画像の取得にログインやAPIキー、クレジットは不要です。次は1,040 × 560のWebPにグレースケールと強度4のぼかしを適用する例です。

https://picsum.org/1040/560.webp?grayscale=1&blur=4

ファイルを開いて形式と実寸を確認し、HTMLのwidthとheightを同じ比率にします。CSSで縮小表示しても、読み込み前の領域が確保されるのでレイアウトがずれにくくなります。写真が意味を持つなら、内容を簡潔に説明する代替テキストを書きます。装飾にしか使わない画像ならaltを空にします。

元の画像サービスに接続できなくなったら?

同じ縦横比のファイルをアプリに同梱します。画像のエラーを検出したら一度だけそのファイルへ切り替え、代替側の読み込みに失敗しても繰り返さないようにします。開発者ツールで外部ホストを一時的にブロックし、スマートフォン幅の画面でも余白や文字がずれないことを確認しましょう。ピクセル単位で比較するスクリーンショットテストなら、外部サービスに接続せずに同梱ファイルだけを使う方が再現しやすくなります。

写真を公開プロジェクトで使うときの確認

Lorem PicsumのカタログはCC0です。別の素材提供元を予備にする場合は、その提供元のライセンスとAPI条件を別途確認します。seedはカタログが同じ間の再現に便利です。長期保存するテストでは、写真そのものと出典を保管します。パラメーターの詳細は 画像URLリファレンス で確認できます。

以前のURLがキーワード付きなら、LoremFlickrからの移行手順 も参照できます。