Lorem Picsum
所有文章
指南

Picsum Photos 掛了怎麼辦?替代方案與備援指南

Picsum Photos 出現 500 錯誤或圖片載不出來?了解如何從瀏覽器與 CI 檢查圖片網址、改用 Lorem Picsum,並為 Storybook 和測試建立本機備援。

picsum.photos 的照片突然載不出來時,先確認出錯的是單一網址、某個執行環境,還是多個網路都能重現的服務問題。看到 Cloudflare 錯誤頁或 5xx,只能確定該次請求沒有正常交付圖片。單憑畫面上的狀態碼,不能判定根因或宣布整個服務中斷。安排網站上線或出測試結果時,可先用本機圖片維持版面。

Picsum Photos 無法載入的排查順序

  1. 將失敗的完整網址貼到新分頁。到「網路」面板確認最後回應的狀態和媒體類型。圖片網址可能先回傳 302,應繼續追到最後一跳。
  2. 分別試試隨機網址、seed 和固定 ID。若只有一條失敗,檢查尺寸順序、檔案格式和該筆照片是否還存在。用 GET 實際解碼圖片,避免只看 200 就當通過。
  3. 從出問題的環境再測一次。瀏覽器能看、CI 無法讀取時,優先找公司代理伺服器、DNS 或出站網路限制。頁面內失敗但新分頁可看時,注意 CSP 和混合內容。
  4. 記錄出錯時間、狀態和可取得的 cf-ray。若不同網路都重複拿到 5xx,可以暫時切到備援,並把記錄交給服務供應方排查。

Picsum Photos 替代服務比較

Lorem Picsum(picsum.org) 使用類似的寬、高路徑,適合版型、測試資料和需要真實照片的示意頁。請先認清網址中的網域,兩個服務各有自己的圖庫與照片 ID。若先前版型由固定 ID 選圖,換網域後要重新找圖,不能直接沿用編號。

Unsplash API 適合以主題搜尋,從候選照片中挑選正式素材。導入前要確認 API 金鑰、速率限制、署名及圖片網址規範。當測試只需要某個比例時,Placehold 的色塊就能驗證容器尺寸。對於不允許連外的環境,專案內附的圖檔最直接。

讓網址遷移和故障復原各自可驗收

下面第一行是舊服務,第二行在新服務保留尺寸並指定 WebP,最後一行為同一個版面準備 seed。先遷移一張卡片,確認裁切、檔案類型和實際像素,再更換其餘元件。

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

把網域放在共用函式或設定裡。需要在同一側欄顯示多張不同照片時,用各自的 seed 或事先選好的 ID,避免隨機結果讓視覺測試一直出現差異。如果原本以隨機查詢參數跳過快取,換成穩定網址可以減少重複請求。換完先跑測試,然後主動擋掉外部圖床,確認本機備援真的會出現。

設定尺寸、格式與本機備援

在 Lorem Picsum 圖片產生器 先選版面比例,輸入寬和高,再複製產生的圖片網址。公開圖片網址支援 JPEG、WebP、每邊最高 2,000 像素的自訂尺寸,以及灰階和模糊,不需要登入、API 金鑰或點數。下列範例會要求 1,040 × 560 的 WebP,轉成灰階並套用強度為 4 的模糊。

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

把圖片放回頁面時,設定與檔案相符的 width 和 height,並用 CSS 決定顯示大小。列出行動版和桌面版兩種顯示方式,檢查在窄螢幕上是否裁掉人物或文字。需要自動載入不同大小時,準備對應的圖片網址供 srcset 使用。替代文字要描述照片提供的資訊。如果只是裝飾,可用空的 alt,讓輔助工具略過。

遠端載不出來時,備援要怎麼測?

把同一個長寬比的備援照片和專案一起打包。圖片載入事件回傳錯誤時,換成本機路徑,並確保錯誤處理最多執行一次,避免備援本身失效時一直重試。開發時可在瀏覽器中封鎖外部網域,確認不會看到破圖、版面不跳動,並檢查替代文字。CI 做螢幕截圖時可以直接從本機讀取測試圖檔,服務是否在線就不會左右測試結果。

授權和輸出規格有什麼要注意?

Lorem Picsum 圖庫的照片是 CC0,日後若替換成其他來源,須重新檢查授權與 API 條款。把重要的測試照片、來源與許可一起留在專案中,團隊交接時才能重建畫面。要覆核參數、分類與公開限制,可查閱 圖片網址參考。

如果你的舊網址含有路徑式關鍵字或 lock,請看 LoremFlickr 替代方案與網址遷移。