NestJS中无法为Redis缓存设置动态TTL的问题

1. 类型错误原因及修复 #

你遇到的Argument of type '{ ttl: number; }' is not assignable to parameter of type 'number'错误，本质是cache-manager v5+ 调整了set方法的参数签名：

• 旧版（v4及以下）：set(key: string, value: any, ttl: number)
• 新版（v5+）：set(key: string, value: any, options: { ttl?: number })

但@nestjs/cache-manager导出的Cache类型未完全同步新版API，导致TypeScript校验报错。可以通过以下两种方式修复：

方式一：导入原生Cache类型 #

直接从cache-manager导入原生类型替代NestJS封装的类型：

import { CACHE_MANAGER } from "@nestjs/cache-manager";
import { Cache } from 'cache-manager'; // 导入cache-manager原生Cache类型
import { Inject } from '@nestjs/common';

constructor(@Inject(CACHE_MANAGER) private cacheManager: Cache) {}

async set<T>(key: string, value: T, ttl?: number): Promise<void> {
  const serializedValue = JSON.stringify(value);
  await this.cacheManager.set(key, serializedValue, { ttl });
}

方式二：临时忽略类型校验 #

如果不想调整导入逻辑，可通过// @ts-ignore跳过类型检查（不推荐长期使用，建议优先同步类型）：

async set<T>(key: string, value: T, ttl?: number): Promise<void> {
  const serializedValue = JSON.stringify(value);
  // @ts-ignore
  await this.cacheManager.set(key, serializedValue, { ttl });
}

2. TTL默认85分钟的原因及解决 #

直接传数字ttl时TTL不生效，是因为cache-manager v5不再支持直接传递数字作为第三个参数，该参数会被忽略，最终使用缓存存储的默认TTL（你看到的85分钟是redis-store的默认配置，或NestJS全局缓存的默认值）。

要让动态TTL生效，必须通过options对象传递ttl，同时注意：

• cache-manager的TTL单位是秒，如果业务逻辑用的是分钟，记得转换（比如10分钟需传600）
• 若全局缓存配置了ttl，动态设置的TTL优先级更高，会覆盖全局默认值

额外配置注意事项 #

确保cache-manager-redis-store的配置适配cache-manager v5+：

// 模块导入示例
import { CacheModule } from '@nestjs/cache-manager';
import { redisStore } from 'cache-manager-redis-store';

@Module({
  imports: [
    CacheModule.registerAsync({
      useFactory: async () => ({
        store: await redisStore({
          url: 'redis://localhost:6379',
          // 全局默认TTL，动态设置的TTL会覆盖此值
          ttl: 3600,
        }),
      }),
    }),
  ],
})
export class AppModule {}

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