EntityFramework-Plus 缓存机制与 EF8 中 OpenJson 转换的兼容性问题解析

问题背景

在 EntityFramework-Plus 项目中，FromCache 是一个强大的缓存功能，它允许开发者轻松地将查询结果缓存起来以提高性能。然而，随着 EF Core 8 的发布，一个潜在的兼容性问题浮出水面。

核心问题

EF Core 8 对 Contains 操作符的 SQL 生成方式进行了重大改变。在 EF Core 7 及以下版本中，类似 list.Contains(column) 的查询会被转换为传统的 IN 子句：

SELECT [e].[Code]
FROM [Tbl] AS [e]
WHERE [e].[Id] IN (1, 2)

而在 EF Core 8 中，同样的查询会被转换为使用 OPENJSON 函数：

SELECT [e].[Code]
FROM [Tbl] AS [e]
WHERE [e].[Id] IN (
  SELECT [i].[value]
  FROM OPENJSON(@__input_0) WITH ([value] int '$') AS [i]
)

问题表现

当使用 EntityFramework-Plus 的 FromCache 功能时，如果缓存了一个基于 Contains 操作的查询（如 listA.Contains(x)），然后尝试使用不同的列表（如 listB.Contains(x)）执行相同查询，缓存系统无法正确识别参数变化，导致返回错误的缓存结果。

技术原理分析

问题的根源在于 EntityFramework-Plus 的缓存键生成机制。在 EF Core 8 之前，缓存系统能够正确识别 IN 子句中参数列表的变化。但当 EF Core 8 改用 OPENJSON 方式后：

1. 参数被封装为 JSON 格式传递
2. 缓存键生成逻辑未能完全适应这种新的参数传递方式
3. 导致不同参数列表被错误地识别为相同查询

临时解决方案

开发者可以通过在 DbContext 配置中添加 UseCompatibilityLevel(120) 来强制 EF Core 8 使用旧的 SQL 生成方式：

optionsBuilder.UseSqlServer(connectionString, 
    options => options.UseCompatibilityLevel(120));

这会使得 EF Core 8 回退到生成传统的 IN 子句，从而绕过 OPENJSON 带来的缓存问题。

官方修复方案

EntityFramework-Plus 团队已经意识到这个问题并在最新版本(8.102.1.0)中提供了修复方案。新版本改进了缓存键生成逻辑，能够正确识别 OPENJSON 格式的参数变化。

最佳实践建议

1. 对于使用 EF Core 8 的项目，建议升级到 EntityFramework-Plus 8.102.1.0 或更高版本
2. 如果暂时无法升级，可以使用兼容性级别回退方案
3. 在性能敏感场景中，建议对新旧两种方案进行基准测试，选择最适合的方案
4. 注意监控缓存命中率和正确性，特别是在参数变化频繁的场景

总结

EntityFramework-Plus 与 EF Core 8 的这次兼容性问题展示了 ORM 框架演进过程中可能遇到的挑战。通过理解底层机制和保持组件更新，开发者可以确保应用程序的稳定性和性能。这次修复也体现了 EntityFramework-Plus 项目对新技术快速适配的能力。