解决 Next.js 项目 bin 目录缺失导致无法启动的问题

报错信息

在执行 pnpm dev 命令启动 Next.js 项目时，遇到以下报错：

Error: Cannot find module 'next'
Require stack:
- D:\Work\mydify\niepan-web\node_modules\.bin\next

这个错误表明 Next.js 的核心模块无法被正常加载，虽然包已安装但实际文件结构不完整。

问题背景

在开发 Next.js 项目时，遇到了项目无法启动的问题。尽管执行了 pnpm i 和删除 node_modules 后重新安装的操作，项目仍然无法正常启动。本文记录了排查和解决这一问题的完整过程。

症状描述

执行 pnpm dev 命令后，项目无法正常启动，没有显示常见的 Next.js 启动信息（如本地服务地址等）。检查发现 node_modules/next/dist/bin 目录为空或不存在，这是 Next.js 启动所必需的关键目录。

环境信息

• 操作系统：Windows 10
• Node.js 版本：v22.11.0
• pnpm 版本：10.6.1
• Next.js 版本：15.2.3

问题分析过程

1. 检查 Node.js 和包管理器版本

首先确认 Node.js 版本和 pnpm 版本是否符合项目要求：

node -v
# 输出: v22.11.0