Linq To DB 查询缓存机制与参数依赖性问题解析

问题背景

在使用 Linq To DB 进行 PostgreSQL JSON 数据查询时，开发人员发现即使查询路径参数不同，系统仍然会从缓存中返回相同的查询结果。这会导致不同路径参数的查询被错误地识别为相同查询，从而返回错误的查询结果。

技术原理分析

Linq To DB 的查询缓存机制默认会缓存查询表达式树，以提高重复查询的性能。然而，这种机制在某些特殊场景下可能会导致问题，特别是当查询中包含动态参数时。

在示例代码中，开发人员定义了一个 JSON 路径查询扩展方法 JsonPathHashString，该方法接收两个参数：JSON 属性名和路径值。由于路径参数没有被标记为查询依赖参数，Linq To DB 的查询缓存机制会认为这些查询是相同的，即使路径参数实际上不同。

解决方案

1. 使用 SqlQueryDependent 属性

正确的解决方案是为路径参数添加 [SqlQueryDependent] 属性，告知 Linq To DB 该参数会影响生成的 SQL 查询，需要针对不同参数值重新生成查询：

[Sql.Extension(ProviderName.PostgreSQL, Precedence = Precedence.Primary,
    BuilderType = typeof(JsonPathHashBuilder<string>), ServerSideOnly = true, CanBeNull = true)]
public static TValue JsonPathHashString<TValue>(string jsonPropName, [SqlQueryDependent] string valuePath)
{
    throw new NotImplementedException();
}

2. 改进查询方法设计

更优雅的实现方式是直接接收 JSON 文档参数，而不是硬编码列名：

[Sql.Extension(ProviderName.PostgreSQL, Precedence = Precedence.Primary,
    BuilderType = typeof(JsonPathHashBuilder<string>), ServerSideOnly = true, CanBeNull = true)]
public static TValue JsonPathHashString<TValue>(JsonDocument document, [SqlQueryDependent] string valuePath)
{
    throw new NotImplementedException();
}

这样使用时更加直观：

var result = dataContext.GetTable<JsonDataEntity>()
    .Where(e => JsonPathHashString<string>(e.Complex, path) == value)
    .ToArray();

高级应用场景

禁用查询缓存

在某些动态查询场景下，如果查询参数变化很大且不希望缓存查询，可以考虑禁用查询缓存：

1. 针对特定数据上下文禁用：

new DataConnection(new DataOptions().UseDisableQueryCache(true))

2. 全局禁用（不推荐在多线程环境中使用）：

Configuration.Linq.DisableQueryCache = true;

最佳实践建议

1. 对于会影响 SQL 生成的参数，始终使用 [SqlQueryDependent] 属性标记
2. 尽量设计扩展方法接收实体属性作为参数，而不是硬编码列名
3. 仅在必要时禁用查询缓存，因为这会降低重复查询的性能
4. 对于高度动态的查询场景，考虑使用参数化查询而不是完全禁用缓存

总结

Linq To DB 的查询缓存机制在大多数情况下能显著提升性能，但在处理动态参数时需要特别注意。通过合理使用 SqlQueryDependent 属性和优化查询方法设计，可以既保持缓存带来的性能优势，又确保查询结果的正确性。理解这些机制有助于开发出既高效又可靠的数据库访问层代码。