NestJS项目中cache-manager包报错求助

开发者阿泽

2026-6-19

解决NestJS中cache-manager的构造函数错误及文件缺失问题

错误原因分析

初始错误（LRUCache不是构造函数）：cache-manager v5.x对LRU存储的导出方式做了变更，若你的@nestjs/cache-manager版本过低，无法适配这种变更，就会抛出该错误。
降级后文件缺失错误：直接修改版本号后未清理旧依赖，导致缓存的依赖结构混乱，或者@nestjs/cache-manager与cache-manager v4.x版本不匹配，引发文件找不到的问题。

解决方案

方案1：升级到兼容的新版本组合

使用@nestjs/cache-manager v2.x+搭配cache-manager v5.x，这是官方推荐的最新兼容组合：

执行升级命令：

npm install @nestjs/cache-manager@latest cache-manager@latest

验证代码中的导入是否正确（你的现有代码已经符合要求）：

// user.service.ts中正确的Cache导入
import { Cache } from 'cache-manager';

方案2：降级到稳定的旧版本组合

若需要使用cache-manager v4.x，需搭配对应的@nestjs/cache-manager v1.x版本，同时清理旧依赖避免缓存问题：

先删除旧依赖文件：

# Linux/Mac
rm -rf node_modules package-lock.json
# Windows
del /s node_modules && del package-lock.json

安装指定版本：

npm install @nestjs/cache-manager@^1.0.0 cache-manager@^4.1.0

额外检查点

确认CacheModule.register()的配置是否正确，若需要自定义存储，可显式指定（比如使用lru-cache）：

// user.module.ts中可添加配置（可选）
import { Module } from '@nestjs/common';
import { CacheModule } from '@nestjs/cache-manager';
import * as LRU from 'lru-cache';

@Module({
  imports: [
    CacheModule.register({
      store: new LRU({
        max: 100,
        ttl: 3600,
      }),
    }),
  ],
  // ...其他配置
})
export class UserModule {}