You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何使用NextJS Image组件展示props传入的图片?报错求助

问题解决:Next.js Image组件外部图片加载报错

从报错信息来看,核心问题是Next.js的Image组件对外部图片域名做了限制。Next.js为了保障安全和优化图片加载性能,默认只允许加载本地图片或已加入白名单的外部域名图片,未配置的域名会直接触发报错。

解决步骤:

  1. 打开项目根目录的next.config.js文件(如果没有则直接新建)
  2. 在配置对象中添加images.domains字段,填入你图片所在的实际域名:
/** @type {import('next').NextConfig} */
const nextConfig = {
  images: {
    // 替换为你图片对应的域名,比如示例中的i.sstatic.net
    domains: ['i.sstatic.net'],
  },
}

module.exports = nextConfig
  1. 重启Next.js开发服务器,配置修改后需要重启才能生效

进阶配置(Next.js 12.3及以上版本)

如果需要支持通配符域名或更复杂的路径规则,可以使用remotePatterns:

images: {
  remotePatterns: [
    {
      protocol: 'https',
      hostname: '**.your-domain.com',
      pathname: '/images/**',
    },
  ],
}

本地图片加载提示

如果是本地图片,确保图片放在项目的public目录下,src直接写/图片文件名即可,无需配置域名白名单。

内容的提问来源于stack exchange,提问作者Mohit

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.09 22:25:48