Next.js 15.2.4启动报错：MODULE_NOT_FOUND问题求助

算力阿峰

2026-6-13

Next.js 15.2.4 启动 MODULE_NOT_FOUND 问题解决思路

问题现象

启动Next.js 15.2.4项目时，无论启用/禁用Turbopack，均抛出MODULE_NOT_FOUND错误，涉及next/package.json、next/dist/compiled/babel/code-frame、@swc/helpers/_/_interop_require_wildcard等模块，清理node_modules、package-lock.json、.next目录后问题依旧。

解决步骤

检查并升级npm版本
Next.js 15对npm版本有最低要求（建议npm 9.x及以上），先确认当前版本：
```
npm -v
```
版本过低则执行升级：
```
npm install -g npm@latest
```
彻底清理缓存并重新安装依赖
除了删除常规文件，还需清理npm缓存，避免损坏的缓存包影响安装：
```
rm -rf node_modules package-lock.json .next
npm cache clean --force
npm install
```

修复依赖版本冲突

react与react-dom版本需保持一致，修改package.json：

"dependencies": {
  "next": "15.2.4",
  "react": "^18.3.1",
  "react-dom": "^18.3.1",
  "sqlite": "^5.1.1",
  "sqlite3": "^5.1.7"
}

Tailwind CSS v4为测试版，可能与Next.js 15存在兼容性问题，替换为稳定版v3，并调整相关依赖：
```
"devDependencies": {
  "@eslint/eslintrc": "^3",
  "tailwindcss": "^3.4.1",
  "postcss": "^8.4.38",
  "autoprefixer": "^10.4.19",
  "eslint": "^9",
  "eslint-config-next": "15.2.4"
}
```
移除@tailwindcss/postcss，并补充postcss和autoprefixer（Tailwind v3必需）。

尝试使用其他包管理器
npm的依赖解析可能出现异常，换用pnpm或yarn重试：
用pnpm：

rm -rf node_modules package-lock.json .next
npm install -g pnpm
pnpm install
pnpm dev

用yarn：

rm -rf node_modules package-lock.json yarn.lock .next
npm install -g yarn
yarn install
yarn dev

手动修复Next.js安装
检查node_modules/next目录是否存在缺失文件（如package.json、dist/compiled/babel/code-frame），若缺失则重新安装Next.js：
```
npm uninstall next
npm install next@15.2.4
```