Troubleshooting

getCache() throws or returns a no-op cache

@quik/cache must be registered in the bootstrap module list and Module.setup() must have run before any code calls getCache().

Redis driver not connecting

Confirm the ioredis peer dependency is installed and that cache.redis.host/cache.redis.port/cache.redis.password/cache.redis.db match your Redis instance.

File driver not persisting entries

Confirm the process has write access to cache.file.folder and that the folder path is correct relative to the process working directory.

Entries expire earlier or later than expected

cache.defaultTtlMs only applies when set() is called without an explicit ttlMs. Per-call ttlMs always takes precedence.