Next.js项目执行npm run build报silly lifecycle错误如何解决

问题原因 #

本次npm run build构建失败的核心原因是Windows系统下的文件权限错误，报错信息里的EPERM: operation not permitted说明Next.js在写入.next目录下的文件时没有足够权限，过程中出现的ESLint警告仅为规范提示，不会直接导致构建中断。

解决方案 #

优先尝试通用修复步骤 #

• 先关闭所有占用项目目录的程序：包括正在运行的npm run dev服务、打开项目的编辑器（如VS Code）、所有关联的终端窗口
• 手动删除项目根目录下的.next文件夹、node_modules文件夹、package-lock.json文件
• 右键点击终端（Powershell/命令提示符），选择「以管理员身份运行」，切换路径到你的项目根目录
• 执行npm install重新安装依赖
• 执行npm run build重试构建

若上述步骤无效可尝试备选方案 #

• 将项目移动到路径更简单、不含特殊符号的目录下重试，比如C:\projects\portfolio，避免原路径里的@前缀、多层嵌套路径带来的权限异常
• 右键点击项目文件夹，选择「属性→安全→编辑」，给当前登录的Windows用户添加「完全控制」权限，保存配置后再重试构建

ESLint警告优化建议 #

以下警告不影响当前构建，但建议后续优化符合Next.js开发规范：

• 不要在普通页面内手动插入<link>样式表标签，全局样式仅需在pages/_app.js中统一引入
• 不要使用同步外部脚本标签，换成Next.js提供的next/script组件加载外部脚本
• 普通<img>标签替换为next/image组件，可自动实现图片压缩、懒加载等优化
• components/MDXComponents.js中的默认导出先赋值给变量再导出，不要直接写export default {}

内容的提问来源于stack exchange，提问作者Simón Sánchez