Next.js圖片元件拒絕外部圖片:remotePatterns怎麼對網址
外部圖片直接打開有圖,放進 Next.js 的 Image 元件卻報「hostname is not configured」。先抄下出錯的完整 src,再與 remotePatterns 一段一段核對。它不是只認域名:協定、主機、port、路徑與查詢字串,都可能讓同一張海報被拒絕。 以下採 Next.js 16 的預設 Image loader。先核專案版本及現有 next.config;若網站用了自訂 loader 或停用最佳化,請求路徑可能不同,不能直接用這份判斷當所有圖片功能的規則。 先找原圖 src,而不是只看最佳化網址 在錯誤訊息中找 Image 的 src,或從 Network 的圖片請求讀取 url 參數。看到 /_next/image?url=... 時,外層是 Next 的最佳化入口,裡面解碼後的 url 才是要拿來比對的外部圖片來源。 例如 https://media.example/account123/poster.png?v=2,可拆成協定 https、主機 media.example、空的非預設 port、路徑 /account123/poster.png,以及查詢字串 ?v=2。這是地址示例,正式設定要換成自己獲准使用的圖片主機與路徑。 留意實際值是否多了一個子域名,或路徑原本是 /account123/,來源卻回傳 /uploads/account123/。不要只看副檔名相同就判定符合。比對以完整 src 為準,不能把頁面所在域名或網址最後跳到哪裡,誤當輸入給 Image 的值。 只放行需要的主機與資料夾 假設這個網站只需要同一帳號資料夾、HTTPS、沒有查詢字串的圖片,可在設定裡寫成: module.exports = { images: { remotePatterns: [{ protocol: 'https', hostname: 'media.example', port: '', pathname: '/account123/**', search: '', }], }, }; 這段是設定片段,應整合進原本的 images 物件,保留既有其他來源。專案若用 next.config.mjs 或 TypeScript 設定檔,沿用對應的匯出方式,不要另外放第二份互相衝突的設定。 pathname...
