使用@nestjs/passport启动项目报错：找不到passport模块或类型声明

你遇到的这个问题其实很常见，@nestjs/passport作为Passport的Nest封装层，它本身并不包含passport核心库，而是把passport列为了peer dependency——也就是说npm不会自动帮你安装它，需要手动添加。另外TypeScript报错找不到类型声明，是因为你还没装对应的类型包。

问题原因拆解 #

• 缺少passport核心依赖：@nestjs/passport只是对Passport的上层封装，实际运行必须依赖原生的passport库，没安装的话Node会找不到这个模块
• 缺失TypeScript类型声明：TypeScript需要@types/passport来识别passport的类型定义，不然会抛出TS2307错误；而编辑器没提示可能是因为编辑器的TS服务还没检测到依赖缺失，或者缓存了旧的依赖信息

解决步骤 #

1. 安装passport核心包：

npm install passport

2. 安装对应的类型声明（开发依赖）：

npm install --save-dev @types/passport

3. 重新启动你的开发服务器：

npm run start:dev

做完这几步，报错应该就消失了。如果编辑器还是有异常提示，试着重启一下编辑器或者手动触发TypeScript服务的刷新（比如VSCode里按Ctrl+Shift+P然后选择"TypeScript: Restart TS Server"）。

内容的提问来源于stack exchange，提问作者PrabodhanaJ