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
相关产品推荐
相关产品推荐

