求助：无法找到模块'next/dist/shared/lib/router/utils/is-bot.js'怎么办？

架构老林

2026-8-18

解决Next.js报错：无法找到模块 'next/dist/shared/lib/router/utils/is-bot.js'

报错信息：错误：无法找到模块 'next/dist/shared/lib/router/utils/is-bot.js'
请求栈：
/home/bastion/Documents/portfolio/portfolio/.next/server/pages/_document.js
/usr/local/lib/node_modules/next/dist/server/require.js
/usr/local/lib/node_modules/next/dist/server/next-server.js
/usr/local/lib/node_modules/next/dist/server/next.js
/usr/local/lib/node_modules/next/dist/server/lib/start-server.js
/usr/local/lib/node_modules/next/dist/cli/next-dev.js
/usr/local/lib/node_modules/next/dist/lib/commands.js
/usr/local/lib/node_modules/next/dist/bin/next

解决步骤

清理构建缓存
删除项目根目录的.next文件夹，再重启开发服务：
```
rm -rf .next
npm run dev
```
重装项目依赖
删除node_modules和锁文件后重新安装：
```
rm -rf node_modules package-lock.json
npm install
```
统一Next.js版本
全局和项目本地的Next.js版本不匹配会引发路径问题：
1. 查看全局版本：npm list -g next
2. 查看本地版本：npm list next
3. 版本不一致时，要么统一版本，要么直接使用项目本地的Next.js命令启动：
```
npx next dev
```
清除npm缓存
缓存损坏可能导致依赖加载异常，执行以下命令后重装依赖：
```
npm cache clean --force
```