NestJS集成Redis缓存遇CACHE_MANAGER注入错误求解决方案

错误原因分析 #

你遇到的CACHE_MANAGER不可用错误，核心是全局缓存模块未正确生效，或是模块间依赖注入上下文未打通。即便你把MyCacheModule导入ItemModule，如果CacheModule的全局配置没加载到位，ItemModule依然拿不到CACHE_MANAGER实例。

快速解决当前错误 #

1. 确保全局缓存模块配置正确 #

修改你的MyCacheModule，确认isGlobal: true生效，且AppModule已正确导入它：

import { Module } from '@nestjs/common'
import { CacheModule } from '@nestjs/cache-manager'
import { ConfigModule, ConfigService } from '@nestjs/config'
// 注意：若使用cache-manager-redis-store v5+，需改为具名导入
import { redisStore } from 'cache-manager-redis-store'

@Module({
    imports: [
        CacheModule.registerAsync({
            isGlobal: true, // 关键：全局注册后，所有模块无需重复导入
            imports: [ConfigModule],
            useFactory: async (configService: ConfigService) => ({
                store: redisStore,
                host: configService.get<string>('cache.host') || 'localhost',
                port: configService.get<number>('cache.port') || 6379,
                ttl: 60, // 默认缓存时长（秒）
            }),
            inject: [ConfigService],
        }),
    ],
})
export class MyCacheModule {}

2. 移除ItemModule中对MyCacheModule的导入 #

因为CacheModule已全局注册，ItemModule不需要再导入MyCacheModule，直接使用CACHE_MANAGER即可：

// ItemModule示例代码
import { Module } from '@nestjs/common';
import { ItemService } from './item.service';

@Module({
  providers: [ItemService],
})
export class ItemModule {}

3. 修正缓存set方法参数（适配新版本） #

如果用的是cache-manager v5+，set方法的过期时间要传入配置对象，不能直接传数字：

// ItemService中修改set代码
await this._cache.set(`item_${id}`, item, { ttl: 60 }); // 替换原直接传60的写法

更简化的集成方案（无需自定义MyCacheModule） #

直接在AppModule里配置全局缓存模块，省去自定义模块的步骤：

import { Module } from '@nestjs/common';
import { CacheModule } from '@nestjs/cache-manager';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { redisStore } from 'cache-manager-redis-store';
import { ItemModule } from './item/item.module';

@Module({
  imports: [
    // 全局注册ConfigModule，其他模块无需重复导入
    ConfigModule.forRoot({ isGlobal: true }),
    // 全局注册Redis缓存
    CacheModule.registerAsync({
      isGlobal: true,
      useFactory: (configService: ConfigService) => ({
        store: redisStore,
        host: configService.get('CACHE_HOST', 'localhost'),
        port: configService.get('CACHE_PORT', 6379),
        ttl: 60,
      }),
      inject: [ConfigService],
    }),
    ItemModule,
  ],
})
export class AppModule {}

依赖版本检查 #

确保安装的依赖版本兼容：

# 安装最新兼容版本
npm install @nestjs/cache-manager@latest cache-manager@latest cache-manager-redis-store@latest

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