Marten 项目中的 Linq 表达式异常问题分析及解决方案

问题背景

在将项目从 .NET 6 迁移到 .NET 8 的过程中，用户同时将 Marten 从 v6.4.1 升级到了 v7.26.2 版本。这一升级导致了一个关于 Linq 表达式处理的异常问题，具体表现为在使用嵌套集合查询时出现了 BadLinqExpressionException 异常。

异常详情

异常信息明确指出："Marten does not (yet) support contains queries through collections of element type "，这表明 Marten 目前还不支持通过特定类型的集合进行包含查询。

问题代码分析

原始查询代码如下：

session.Query<DbObject>().Where(x => x.nestedReadOnlyCollection.ToList().Contains(someSearchedValue));

这段代码在 Marten v6.4.1 中可以正常工作，但在 v7.26.2 中会抛出异常。核心问题在于查询中使用了 ToList() 方法调用。

技术原理

Marten 是一个 .NET 的文档数据库和事件存储库，它使用 PostgreSQL 作为后端存储。当执行 Linq 查询时，Marten 需要将这些查询转换为 PostgreSQL 兼容的 SQL 语句。

在 Marten 7.x 版本中，查询解析器变得更加严格，不再支持在查询中间接调用 ToList() 方法。这是因为：

1. ToList() 是一个内存中的操作，而 Marten 需要将整个查询转换为 SQL 语句在数据库端执行
2. 中间调用 ToList() 会中断查询的连续转换过程
3. 新版本对 Linq 表达式的解析更加精确，能够检测到这种不支持的用法

解决方案

根据 Marten 项目维护者的建议，正确的做法是直接使用集合的 Contains 方法，而不需要先调用 ToList()：

session.Query<DbObject>().Where(x => x.nestedReadOnlyCollection.Contains(someSearchedValue));

这种写法更加简洁，也符合 Marten 的查询转换规则。它能够被正确转换为 PostgreSQL 的 ANY 或 IN 子句。

深入理解

对于嵌套集合查询，Marten 实际上支持以下几种场景：

1. 简单值类型的集合查询（如 int[], List<string> 等）
2. 复杂对象的集合查询（需要特殊的处理方式）
3. 多级嵌套集合查询（有一定的限制条件）

在升级过程中，开发者需要注意 Marten 对 Linq 支持的变化，特别是在处理集合操作时。新版本通常会：

• 增加对更多标准 Linq 操作的支持
• 移除一些不规范的用法支持
• 提高查询转换的精确性

最佳实践

1. 避免在 Marten 查询中使用内存操作方法（如 ToList(), ToArray() 等）
2. 对于复杂查询，考虑使用 Marten 的 SQL 查询功能
3. 在升级前仔细阅读版本变更说明，特别是关于 Linq 支持的变化
4. 对于不确定的查询，可以先在测试环境中验证

总结

Marten 7.x 版本对 Linq 查询的支持更加严格和规范，这虽然可能导致一些旧代码需要调整，但提高了查询的可靠性和一致性。开发者应该遵循 Marten 推荐的查询模式，避免使用中间内存操作，以确保查询能够正确转换为 SQL 语句并在数据库端高效执行。