Cache-Manager中Uint8Array缓存问题的分析与解决

问题背景

在使用Cache-Manager进行数据缓存时，开发者发现了一个关于Uint8Array类型数据的异常行为。当首次将Uint8Array对象存入缓存时，能够正常返回该类型对象；但当从缓存中读取时，返回的却是一个普通对象而非Uint8Array实例。这一问题在Cache-Manager从v5升级到v6版本后出现，属于一个回归性错误。

问题现象

具体表现为：

• 首次获取数据时返回正确的Uint8Array对象
• 后续从缓存读取时返回的是普通对象格式（如{ '0': 1, '1': 2, '2': 3 }）

这种不一致性会导致依赖Uint8Array特定方法和属性的代码在后续调用时出现错误。

技术分析

该问题的根源在于Cache-Manager v6版本底层使用了Keyv作为存储适配层。Keyv默认会对所有数据进行序列化处理，即使是在内存缓存场景下也是如此。这种设计源于历史兼容性考虑，但对于二进制数据类型如Uint8Array来说，序列化/反序列化过程会导致类型信息丢失。

Uint8Array是一种特殊的类型化数组，用于表示8位无符号整型数组。当它被序列化为JSON时，会转换为一个普通对象；反序列化时如果没有特殊处理，就无法恢复为原来的Uint8Array实例。

解决方案

要解决这个问题，可以通过禁用Keyv的序列化功能来实现：

import { createCache } from "cache-manager";
import { Keyv } from "keyv";

const keyv = new Keyv();
keyv.serialize = undefined;
keyv.deserialize = undefined;

const memoryCache = createCache({
    stores: [keyv],
});

这种方法直接关闭了Keyv的序列化/反序列化流程，使得Uint8Array等特殊类型能够保持原样存储和读取。

最佳实践建议

1. 二进制数据处理：当缓存中包含二进制数据时，建议显式禁用序列化
2. 版本升级注意：从v5升级到v6时，需要特别检查二进制数据的处理逻辑
3. 类型检查：在消费缓存数据时，可添加类型检查确保数据格式符合预期
4. 性能考量：对于纯文本数据，保持序列化可能更高效；二进制数据则相反

总结

Cache-Manager v6通过引入Keyv作为存储适配层带来了许多改进，但也改变了某些数据类型的处理方式。理解这些底层机制对于正确处理特殊数据类型至关重要。通过合理配置序列化选项，开发者可以确保Uint8Array等类型在缓存过程中保持完整，避免潜在的类型错误问题。