使用EF Core 3.1查询Azure Cosmos DB时List<SubItem>属性未映射的问题求助

我帮你分析了一下你遇到的EF Core 3.1和Cosmos DB映射的问题，SubItems始终返回null的根源主要在嵌套拥有实体的配置不完整，结合你的代码和文档结构，下面是具体的解决思路和修正方案：

1. 补全嵌套层级的JsonProperty配置 #

你目前只给SubItems指定了ToJsonProperty("SubItems")，但外层的Items集合没有指定对应的JsonProperty。EF Core对于拥有实体集合，默认可能会生成带前缀的属性名（比如Items_Items），这就和你Cosmos DB文档里的Items字段对不上，连带着嵌套的SubItems也没法被正确解析。

另外，给SubItem的每个属性显式指定JsonProperty也能避免潜在的大小写或命名风格不匹配问题，让映射更稳妥。修正后的ApplicationDbContext配置如下：

public class ApplicationDbContext : DbContext
{
    public DbSet<Model> Models { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 记得补充你的Cosmos DB连接配置
        optionsBuilder.UseCosmos("你的Cosmos连接字符串", "数据库名称");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.HasDefaultContainer("Models");
        
        modelBuilder.Entity<Model>(lr =>
        {
            lr.ToContainer("Models");
            lr.HasKey(lr => lr.DeviceId);
            lr.HasNoDiscriminator();
            
            // 给Items集合指定对应文档的"Items"字段
            lr.OwnsMany(o => o.Items, na =>
            {
                na.ToJsonProperty("Items");
                
                // 给SubItems指定对应文档的"SubItems"字段，同时显式映射每个属性
                na.OwnsMany(o => o.SubItems, sa =>
                {
                    sa.ToJsonProperty("SubItems");
                    sa.Property(s => s.field1).ToJsonProperty("field1");
                    sa.Property(s => s.field2).ToJsonProperty("field2");
                    sa.Property(s => s.field3).ToJsonProperty("field3");
                    sa.Property(s => s.field4).ToJsonProperty("field4");
                    sa.Property(s => s.field5).ToJsonProperty("field5");
                });
                
                // 如果Items还有其他自定义字段，也建议显式指定JsonProperty，比如：
                // na.Property(i => i.YourOtherField).ToJsonProperty("YourOtherField");
            });
        });
    }
}

2. 显式加载嵌套集合（更稳妥的做法） #

虽然EF Core对于Cosmos DB的拥有实体默认应该自动加载，但3.1版本偶尔会有加载逻辑的小问题，显式用Include+ThenInclude能确保嵌套集合被正确获取。修改你的查询代码：

Model model = await _context.Models
    .Include(m => m.Items)
        .ThenInclude(i => i.SubItems)
    .FirstOrDefaultAsync(m => m.DeviceId == deviceID);

3. 检查字段名大小写匹配 #

EF Core 3.1的属性映射是区分大小写的，确保你的实体类属性名和Cosmos DB文档里的字段名完全一致——你现在的SubItem属性都是小写，和文档匹配，这部分没问题，但如果Items有其他字段大小写不一致，也会导致映射失败。

4. 验证生成的查询语句（排查问题用） #

如果还是有问题，可以开启EF Core的日志，查看生成的Cosmos DB SQL查询，确认是否包含了SubItems字段的投影。在OnConfiguring里加日志配置：

optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);

执行查询后看控制台输出，要是生成的SQL里没包含SubItems，那说明配置还是有问题，得再检查映射规则。

按照上面的步骤修改后，你的SubItems集合应该就能正确映射到Cosmos DB里的数据了。

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