EF Core 2.0中如何为实体包含的Owned Type属性创建索引？

你提到的这个问题确实很典型——EF Core 2.0里对Owned Type的索引支持确实和导航属性有类似的限制，而且官方的异常提示确实有点让人摸不着头脑。不过你找对方向了，下面给你明确的配置方式：

核心结论 #

在EF Core 2.0中，不能直接通过DataAnnotations（比如[Index]特性）给Owned Type的属性创建索引，必须使用Fluent API来完成配置，这也是解决这类问题的标准方案。

具体示例 #

假设你有如下实体和Owned Type的定义：

// 主实体
public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 包含的Owned Type
    public ContactInfo Contact { get; set; }
}

// Owned Type
public class ContactInfo
{
    public string Email { get; set; }
    public string PhoneNumber { get; set; }
}

要给ContactInfo的Email创建单属性索引，或者给Email+PhoneNumber创建复合索引，需要在DbContext的OnModelCreating方法里这样配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 先配置主实体与Owned Type的关系
    modelBuilder.Entity<Customer>()
        .OwnsOne(c => c.Contact, contactBuilder =>
        {
            // 给单个属性创建索引
            contactBuilder.HasIndex(ci => ci.Email);
            
            // 给多个属性创建复合索引
            contactBuilder.HasIndex(ci => new { ci.Email, ci.PhoneNumber });
        });
}

为什么不能用DataAnnotations？ #

EF Core 2.0在处理Owned Type时，会将其视为主实体的一部分（而非独立实体），[Index]特性无法被框架正确识别为针对Owned Type属性的索引配置，反而会抛出类似针对导航属性的异常——这就是你感受到的“和导航属性创建索引相同的问题”，微软的异常文本确实没有直接点明根源，容易让人困惑。

额外说明 #

如果你后续升级到EF Core 3.0及以上版本，部分场景下可以通过更简洁的方式配置，但在2.0版本中，上述Fluent API的方式是唯一稳定可行的方案。

内容的提问来源于stack exchange，提问作者S. McChesney