Next.js v14本地Netlify构建报错：@netlify/plugin-nextjs提示netlifyConfig.images只读

1. 是否有其他用户遇到同类问题？ #

有大量用户在Netlify社区讨论区和GitHub Issues中反馈过相同问题，集中出现在Next.js v14搭配@netlify/plugin-nextjs v5.x早期版本（包括v5.9.3）的场景下，报错信息均为Error: "netlifyConfig.images" is read-only。

2. 解决方法（实现v5.x版本下本地构建成功） #

• 升级插件到兼容版本：直接升级@netlify/plugin-nextjs至最新稳定版（v5.10.0及以上版本已修复此兼容性问题），执行命令：

  npm install @netlify/plugin-nextjs@latest --save-dev
  

• 调整配置逻辑：若暂时无法升级插件，需移除netlify.toml或自定义插件钩子中直接修改netlifyConfig.images的代码，改用Next.js原生的next.config.js配置文件中的images字段管理图像相关设置
• 清理本地缓存：执行netlify cache:clear清空本地构建缓存后，重新运行netlify build命令

3. 问题根源：兼容性还是配置问题？ #

核心是插件版本与Next.js v14的兼容性问题。Next.js v14对图像配置的内部处理逻辑和结构进行了调整，而@netlify/plugin-nextjs v5.9.3版本未适配这一变化，仍尝试修改Netlify构建配置中被标记为只读的images字段，从而触发报错。少数情况可能是用户自定义的Netlify配置逻辑（如手动修改images配置）触发了只读限制，但本质还是旧版插件未适配Next.js v14的新机制。

内容的提问来源于stack exchange，提问作者Ahsan Hafeez