Vercel部署含multer的后端代码时提示找不到multer包

算力阿峰

2026-6-28

Vercel部署Express后端时提示找不到multer包的解决办法

问题描述

在Vercel上部署使用multer的Express后端代码时，出现以下错误：

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'multer' imported from /var/task/backend/controllers/entriesController.js
INIT_REPORT Init Duration: 308.35 ms Phase: init Status: error Error Type: Runtime.ExitError
Error: Runtime exited with error: exit status 1

项目的package.json依赖已包含multer：

"dependencies": {
    "body-parser": "^1.20.2",
    "cors": "^2.8.5",
    "dotenv": "^16.3.1",
    "express": "^4.18.2",
    "firebase": "^9.23.0",
    "firebase-admin": "^12.0.0",
    "luxon": "^3.4.4",
    "multer": "^1.4.5-lts.1",
    "uuid": "^9.0.1"
}

解决方法

重新安装本地依赖：
删除本地的node_modules文件夹和package-lock.json（或yarn.lock）文件，执行npm install或yarn install重新安装所有依赖，确认依赖安装完整后再提交代码到仓库。Vercel会根据锁文件安装依赖，本地依赖缺失可能导致部署时同步出错。
调整Vercel部署命令：
如果后端代码不在项目根目录（比如在backend子文件夹），需要在Vercel项目设置中修改Install Command为cd backend && npm install，确保Vercel在正确的目录下执行依赖安装操作。
检查模块导入语法：
确认entriesController.js中的multer导入方式与项目模块规范匹配：
- 若项目使用ES模块（package.json中配置"type": "module"），导入语法应为：
```
import multer from 'multer';
```
- 若使用CommonJS规范，导入语法应为：
```
const multer = require('multer');
```
语法不匹配会导致模块查找失败。
排查Vercel构建日志：
查看Vercel部署时的构建日志，确认multer是否被成功安装。如果日志中无multer安装记录，检查是否存在.vercelignore文件误排除了node_modules或package.json，或者package.json文件位置是否不在Vercel识别的根目录下。