解决node-cache-manager中Cacheable存储BigInt类型数据的问题

在Node.js应用中，缓存管理是一个非常重要的性能优化手段。node-cache-manager作为一个流行的缓存抽象层，提供了统一的API来操作多种缓存存储。然而，在使用其Cacheable功能时，开发者可能会遇到无法直接存储包含BigInt类型数据对象的问题。

问题背景

Cacheable默认会对所有存储的数据进行序列化处理，这在大多数情况下是有益的，可以确保数据在不同存储后端之间的一致性。但当我们需要使用内存缓存(如KeyvCacheableMemory)时，这种强制序列化反而成为了不必要的性能开销，特别是当数据中包含BigInt等特殊类型时。

问题分析

Cacheable的primary存储默认通过Keyv进行包装，而Keyv会对数据进行序列化/反序列化处理。这种设计对于需要持久化的存储后端(如Redis、MongoDB等)是必要的，但对于纯内存缓存来说，这种额外的序列化处理：

1. 增加了不必要的CPU开销
2. 可能导致特殊数据类型(如BigInt、Date等)的信息丢失
3. 降低了内存缓存的性能优势

解决方案

最新版本的Keyv(v5.2.1及以上)提供了绕过序列化的能力，我们可以通过以下方式实现：

import Keyv from 'keyv';
import {KeyvCacheableMemory, Cacheable} from 'cacheable';

// 创建内存存储实例
const primary = new Keyv({ store: new KeyvCacheableMemory });

// 关键步骤：禁用序列化
primary.serialize = undefined;
primary.deserialize = undefined;

// 创建Cacheable实例
const cache = new Cacheable({ primary });

这种方法直接操作Keyv实例，将其序列化方法设为undefined，从而绕过默认的序列化流程。这特别适合以下场景：

• 纯内存缓存应用
• 需要存储包含BigInt、Date等特殊类型的对象
• 对性能有极高要求的应用场景

注意事项

1. 此方案仅适用于内存缓存，如果使用需要持久化的存储后端，仍需确保数据可序列化
2. 禁用序列化后，存储的数据将直接保存在内存中，需要注意内存使用情况
3. 如果需要在不同存储后端之间共享数据，仍需考虑序列化兼容性问题

总结

通过禁用Keyv的序列化功能，我们可以高效地在node-cache-manager的内存缓存中存储包含BigInt等特殊类型的对象。这种优化既保留了Cacheable提供的统一API和功能特性，又避免了不必要的性能开销，是内存缓存场景下的理想解决方案。