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

Next.js 14.1.0报错:experimental字段存在未识别的'images'键

问题

将Next.js 14.1.0项目部署到GitHub Pages时,GitHub流水线抛出错误:

Unrecognized key(s) in object: 'images' at "experimental"

当前项目的next.config.mjs代码如下:

/** @type {import('next').NextConfig} */
const nextConfig = {};

export default nextConfig;
解决方案

Next.js 14.1.0已移除experimental.images配置项,该功能已迁移至顶层的images字段。虽然你当前的配置文件中未显式声明该过时项,但可能是项目依赖的插件、第三方工具或GitHub流水线配置中注入了该配置,导致报错。可按以下步骤处理:

  • 排查项目中是否有其他配置扩展文件、第三方插件在动态修改nextConfig,找到experimental.images相关代码,将其移至顶层的images字段下
  • 检查GitHub流水线的配置文件(通常在.github/workflows目录下的yml文件),若流水线中指定了Next.js配置参数,将experimental.images替换为顶层images
  • 手动在next.config.mjs中显式声明顶层images配置,覆盖可能的注入项,示例:
/** @type {import('next').NextConfig} */
const nextConfig = {
  images: {
    // 根据需求配置图片域名、远程规则等,比如:
    domains: ['your-image-domain.com'],
  },
  experimental: {
    // 移除所有与images相关的配置内容
  },
};

export default nextConfig;
  • 清理依赖缓存并重新安装:
rm -rf node_modules package-lock.json yarn.lock
npm install
  • 重新触发GitHub流水线部署

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.29 05:43:12