FusionCache v2.3.0 版本发布：缓存键访问与内部字符串定制化升级

项目简介

FusionCache 是一个高性能的 .NET 缓存库，它提供了多级缓存（内存缓存和分布式缓存）的无缝集成，并内置了缓存击穿保护、并发控制、自动刷新等高级功能。作为一个现代化的缓存解决方案，FusionCache 简化了开发者在处理缓存时的复杂性，同时提供了丰富的定制选项。

v2.3.0 版本亮点

1. 工厂上下文中访问缓存键

在之前的版本中，开发者在工厂方法中无法直接访问当前操作的缓存键。v2.3.0 版本新增了在工厂上下文中访问缓存键的能力，包括原始键和处理后的键。

cache.GetOrSet<string>(
  "foo",
  (ctx, token) => {
    var processedKey = ctx.Key;    // 处理后的缓存键
    var originalKey = ctx.OriginalKey; // 原始缓存键
    // 业务逻辑...
  }
);

这一改进特别适用于需要根据缓存键执行特定逻辑的场景，例如：

• 根据键名决定数据源
• 实现键名相关的日志记录
• 执行键名相关的性能监控

2. 内部字符串定制化选项

FusionCache 内部使用特定字符串作为分隔符和前缀，这在某些特殊环境下（如 NATS 消息系统）可能造成兼容性问题。新版本引入了 InternalStrings 配置选项，允许开发者自定义这些内部字符串。

var options = new FusionCacheOptions()
{
  InternalStrings = {
    TagCacheKeyPrefix = "tag__",
    ClearRemoveTag = "clear_remove",
    DistributedCacheWireFormatSeparator = "|"
  }
};

更便捷的是，可以使用预设的安全字符串配置：

options.InternalStrings.SetToSafeStrings();
// 或带参数的自定义
options.InternalStrings.SetToSafeStrings(separator: '-', specialChar: '_');

这一特性特别适合：

• 需要与特定消息系统集成的场景
• 有严格字符限制的环境
• 需要统一命名规范的企业应用

3. 基于键的缓存项选项提供器

新版本引入了 FusionCacheEntryOptionsProvider 抽象类，允许开发者实现基于键的自定义缓存项选项逻辑。

public class CustomOptionsProvider : FusionCacheEntryOptionsProvider
{
    public override FusionCacheEntryOptions? GetEntryOptions(
        FusionCacheEntryOptionsProviderContext ctx, 
        string key, 
        out bool canMutate)
    {
        // 根据key返回特定的选项
        canMutate = false; // 指示返回对象是否可修改
        return new FusionCacheEntryOptions(...);
    }
}

这一设计考虑到了性能因素，通过 canMutate 参数避免了不必要的对象复制。典型应用场景包括：

• 不同业务域使用不同的过期策略
• 热点数据特殊处理
• 基于键前缀的缓存策略分组

4. 只读方法修复

修复了 TryGet 和 GetOrDefault 等只读方法未正确考虑 SkipDistributedCacheRead 选项的问题。现在这些方法会：

• 当设置 SkipDistributedCacheRead 时，跳过分布式缓存检查
• 提高缓存未命中时的性能
• 保持行为一致性

5. 测试框架升级与增强

项目测试框架已升级至 xUnit v3，并新增了大量测试用例，目前测试覆盖率：

• 单元测试：近1500个
• 集成测试全面覆盖主要功能点
• 边界条件测试更加完善

文档更新

v2.3.0 版本同步更新了相关文档，重点包括：

• 明确了 Clear 方法不同参数的行为差异
• 详细说明了 Expire 方法的工作原理
• 完善了多级缓存中数据封装的说明
• 补充了标签功能的常见问题解答

升级建议

对于现有用户，建议关注以下升级点：

1. 如果使用了自定义的缓存键处理逻辑，检查是否可以利用新的上下文键访问功能简化代码
2. 在NATS等特殊环境中运行时，考虑使用新的安全字符串配置
3. 复杂的缓存策略场景可评估使用基于键的选项提供器

FusionCache v2.3.0 通过这些小而精的改进，进一步提升了灵活性和兼容性，同时保持了API的简洁性和一致性，是追求高效缓存解决方案的.NET开发者的优选工具。