Cache-Manager 项目中同步创建缓存存储的配置问题解析

在 Node.js 缓存管理库 Cache-Manager 的使用过程中，开发者可能会遇到一个常见的配置误区——当同步创建内存缓存存储时，配置参数未能正确传递给底层存储引擎。这个问题在官方文档的示例代码中曾经存在，可能导致开发者设置的缓存限制和过期时间等参数完全失效。

Cache-Manager 提供了两种创建缓存的方式：异步的 caching() 方法和同步的 createCache() 方法。在异步方式下，配置参数会被正确地传递给存储引擎，如内存存储(memoryStore)。然而在同步创建方式中，文档示例直接将配置参数传递给了 createCache() 而非存储引擎构造函数，这实际上是一个错误的用法。

正确的做法应该是将配置参数直接传递给存储引擎的构造函数。以内存缓存为例，应当这样使用：

// 正确的同步创建内存缓存方式
const memoryCache = createCache(memoryStore({
  max: 100,            // 最大缓存项数
  ttl: 10 * 1000       // 缓存过期时间(毫秒)
}));

这个问题的根源在于 Cache-Manager 的架构设计。缓存配置参数实际上是由存储引擎而非缓存管理器本身处理的。例如，max 参数控制内存存储中最多保留多少缓存项，ttl 参数决定缓存项的存活时间，这些功能都是在存储引擎层面实现的。

对于开发者而言，理解这一点非常重要。在使用任何 Cache-Manager 的存储引擎时，都应该仔细阅读对应存储引擎的文档，确认哪些配置参数是由存储引擎处理的，并确保这些参数被正确地传递给存储引擎而非缓存管理器。

Cache-Manager 团队已经注意到这个问题并更新了文档，但开发者在使用时仍需保持警惕，特别是在使用同步创建缓存的方式时。正确的参数传递方式能够确保缓存系统按照预期工作，避免出现缓存不失效或内存泄漏等问题。