Vercel部署API应用报错Cannot find module '@redis/client'，本地正常如何解决？

问题分析 #

redis@4.x 版本本身将 @redis/client 作为核心依赖包，不需要单独手动安装。部署报错的原因通常是依赖安装不完整、版本冲突或Vercel构建缓存导致的依赖缺失。

修复步骤 #

• 清理本地依赖并重新安装

  1. 删除本地的 node_modules 文件夹、package-lock.json（或 yarn.lock）文件
  2. 执行 npm install（或 yarn install）重新安装依赖
  3. 确保 package.json 中只保留 "redis": "^4.0.2"，移除手动添加的 "@redis/client" 依赖（避免版本冲突）

• 检查Vercel构建配置

  1. 进入Vercel项目的「Settings」→「Build & Development Settings」
  2. 将「Install Command」设置为 npm install（强制使用npm安装依赖，避免其他包管理器的兼容性问题）
  3. 确认「Build Command」是正确的项目构建命令（纯Node.js API若无需构建，只需确保依赖安装步骤正常执行）

• 强制清除Vercel构建缓存重新部署

  1. 进入Vercel项目的「Deployments」页面
  2. 找到最近的部署记录，点击「Redeploy」
  3. 取消勾选「Use existing Build Cache」，然后点击「Redeploy」，让Vercel完全重新安装依赖并构建

• 验证本地依赖树
  执行 npm list @redis/client，确认该包已被 redis@4.0.2 正确引入，且版本与redis主包兼容。如果出现版本不匹配，可将redis版本锁定为固定值 "redis": "4.0.2"（去掉^），避免自动升级到不兼容的子版本

• 检查代码导入方式
  确保代码中是从redis包导入客户端，而非直接导入@redis/client：

  // CommonJS写法
  const { createClient } = require('redis');
  // ES模块写法
  import { createClient } from 'redis';
  

内容的提问来源于stack exchange，提问作者Pm Rivière