.NET 9 中数组Contains方法的行为变更解析

在.NET 9的升级过程中，开发人员需要注意一个重要的行为变更：数组类型上的Contains方法在LINQ查询中的使用方式发生了变化。这个变更主要影响使用Entity Framework Core进行数据库查询的场景。

问题现象

当开发人员尝试在LINQ查询中使用数组的Contains方法时，例如在Where条件中检查某个字段值是否存在于给定的Guid数组中，会收到类型加载异常(TypeLoadException)。错误信息表明系统无法正确处理泛型参数约束，特别是当涉及到ReadOnlySpan类型的转换时。

技术背景

在.NET 8及更早版本中，数组类型隐式实现了IEnumerable接口，因此可以直接使用LINQ的Contains扩展方法。然而，.NET 9对底层类型系统进行了优化，特别是在处理Span和ReadOnlySpan等高性能类型时，这种隐式转换的行为发生了变化。

解决方案

目前有两种可行的解决方法：

1. 显式调用ToList()方法将数组转换为列表：

return await appContext.Entity
    .Where(x => ids.ToList().Contains(x.Id))
    .ToListAsync();

2. 使用Any方法替代Contains：

return await appContext.Entity
    .Where(x => ids.Any(id => id == x.Id))
    .ToListAsync();

影响范围

此变更主要影响以下场景：

• 使用数组作为查询参数的LINQ to Entities查询
• 特别是Guid数组等值类型数组的Contains操作
• Entity Framework Core的查询转换过程

最佳实践建议

对于需要频繁进行包含检查的场景，建议：

1. 优先使用List集合而非数组作为参数类型
2. 在性能敏感的场景中，考虑使用HashSet来提高查找效率
3. 对于大型数据集，可以使用Any方法配合相等比较来替代Contains

未来展望

微软团队已经确认这是一个已知问题，并计划在.NET 9.0.4版本中发布修复。在此期间，开发人员可以采用上述变通方案来保持代码的正常运行。