使用Azure Cosmos EF Core时ToListAsync/ToList查询过慢问题咨询

针对你遇到的EF Core Cosmos查询耗时5秒的问题，可以从以下几个方向优化：

• 确保查询字段有合适的索引
  Cosmos DB的查询性能严重依赖索引。默认情况下容器会创建范围索引覆盖所有字段，但如果你的容器修改过索引策略，需要确认PartnerId字段被包含在索引中。
  在EF Core中，可以通过Fluent API明确配置索引：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<BookingEntity>()
          .HasIndex(b => b.PartnerId);
  }
  

  也可以直接在Azure门户的容器索引策略里，确认/PartnerId路径被设置为范围索引。

• 利用分区键减少扫描范围
  如果PartnerId是你的容器分区键，查询时一定要指定分区键，让Cosmos DB直接定位到目标分区，避免跨分区扫描：

  var result = await _context.Bookings
      .WithPartitionKey(partnerId)
      .Where(x => x.PartnerId == partnerId)
      .ToListAsync();
  

  如果PartnerId不是分区键，建议评估是否可以将其设为分区键（需结合数据访问模式），或者调整数据模型让相同PartnerId的数据集中在同一分区。

• 使用投影减少数据传输
  如果业务不需要BookingEntity的所有字段，只查询需要的属性，减少序列化和传输的数据量：

  var result = await _context.Bookings
      .Where(x => x.PartnerId == partnerId)
      .Select(x => new 
      {
          x.Id,
          x.PartnerId,
          x.BookingTime,
          x.CustomerName
      })
      .ToListAsync();
  

  这样返回的结果体积更小，处理速度更快。

• 分页查询避免一次性加载大量数据
  如果查询结果集很大（比如上千条），一次性加载所有数据会导致内存和网络开销过大。用分页逐步获取数据：

  // 示例：每页取100条
  int pageSize = 100;
  int pageNumber = 1;
  var result = await _context.Bookings
      .Where(x => x.PartnerId == partnerId)
      .Skip((pageNumber - 1) * pageSize)
      .Take(pageSize)
      .ToListAsync();
  

  对于超大结果集，还可以使用Cosmos DB的延续令牌（Continuation Token）实现高效分页，EF Core中可以通过AsAsyncEnumerable结合令牌处理。

• 禁用跟踪提升EF Core性能
  如果查询后的实体不需要被EF Core跟踪（比如只用于展示，不做修改），使用AsNoTracking()减少EF Core的内存开销和处理时间：

  var result = await _context.Bookings
      .AsNoTracking()
      .Where(x => x.PartnerId == partnerId)
      .ToListAsync();
  

• 检查Cosmos DB账户的吞吐量配置
  如果你的容器RU/s（请求单位）设置过低，查询可能会被限流，导致耗时增加。可以在Azure门户查看容器的监控指标，确认是否有RU使用率超过限制的情况，适当调高RU值或启用自动缩放功能。

• 升级EF Core Cosmos版本
  确保你使用的是最新版本的Microsoft.EntityFrameworkCore.Cosmos，新版本通常会修复性能问题并优化查询生成逻辑。

内容的提问来源于stack exchange，提问作者Humzamanzur