在Linux Mint系统运行Next.js应用出现报错该如何解决?
Next.js 全新项目dev服务启动报错排查方案
- 检查Node.js版本适配性
稳定版Next.js 13.4+要求Node.js版本≥18.17.0,执行node -v查看本地版本,若低于要求版本,升级到Node.js LTS长期支持版本即可,可使用nvm做多版本管理避免环境冲突。 - 重装依赖清除缓存
依赖拉取异常是最常见的报错原因,按顺序执行以下操作:- 删除项目根目录下的
node_modules文件夹、package-lock.json文件 - 执行
npm cache clean --force清除npm全局缓存 - 执行
npm install重新安装所有依赖 - 执行
npm run dev尝试启动服务
- 删除项目根目录下的
- 排查端口占用问题
Next.js默认占用3000端口,若端口被其他服务占用会启动失败:- macOS/Linux执行
lsof -i:3000查看端口占用进程 - Windows执行
netstat -ano | findstr "3000"查看端口占用进程
可以终止占用3000端口的进程,或者启动时指定其他端口:npm run dev -- -p 3001
- macOS/Linux执行
- 排查初始化配置问题
若初始化时选择了试验性功能、自定义模板等特殊配置,可重新执行默认初始化命令npx create-next-app@latest demo-project,所有配置选择默认选项,初始化完成后再启动测试,排查是否为自定义配置导致的报错。 - 检查文件夹读写权限
若项目放在系统根目录、需要管理员权限的文件夹内,会因为读写权限不足报错,将项目移动到普通用户目录下再尝试启动即可。
内容的提问来源于stack exchange,提问作者Ehtesham Siddiqui
相关产品推荐
相关产品推荐

