如何在领域架构中使用ASP.NET Identity并解决项目间循环引用问题

核心问题本质 #

你遇到的循环引用是因为分层依赖规则要求上层只能依赖下层，不能下层反引上层，而你把和领域实体Company有关联的AppUser放在了最上层的API层，导致领域层要用到Company时必须反向引用API层，违反了分层规则。

可落地的三种解决方案 #

方案1：接口隔离拆分AppUser定义（改造成本最低） #

用接口把Identity框架的实现和领域业务规则解耦：

• 领域层只定义业务需要的IAppUser接口，包含用户Id、关联的CompanyId等核心业务属性，Company类直接和IAppUser配置一对多关联，完全不依赖Identity框架
• API层的AppUser同时继承IdentityUser和领域层的IAppUser接口，既兼容UserManager等Identity组件的调用，也符合领域层的业务约束
• 数据访问层配置EF实体关系时直接绑定AppUser和Company即可，数据库结构不需要做任何调整

代码示例：

// 领域层代码
public interface IAppUser
{
    string Id { get; set; }
    Guid CompanyId { get; set; }
    Company Company { get; set; }
}

public class Company
{
    public Guid Id { get; set; }
    public string CompanyName { get; set; }
    public List<IAppUser> Users { get; set; }
}

// API层代码
public class AppUser : IdentityUser, IAppUser
{
    // Identity自带的Id、UserName等属性直接复用，自动匹配IAppUser的定义
    public Guid CompanyId { get; set; }
    public Company Company { get; set; }
}

方案2：新增无依赖的共享实体层 #

如果你的业务里大量用到用户和其他领域实体的关联，可以新建一个纯实体的共享项目：

• 新增项目命名为[你的项目名].Domain.Shared，该层只放实体、接口、常量，不依赖任何上层应用层/API层的引用，只需要安装无AspNet依赖的Identity核心包Microsoft.Extensions.Identity.Stores
• 把AppUser、Company类都放到该共享层，AppUser直接继承IdentityUser配置和Company的一对多关联
• 领域层、API层、数据访问层都引用该共享层，完全不会产生循环引用

方案3：弱关联替代强导航属性 #

如果不想调整现有实体结构，可以移除实体间的强导航属性依赖：

• 去掉Company类里的List<AppUser> Users导航属性，只在AppUser中保留CompanyId外键字段
• 领域层需要查询公司对应的用户时，通过仓储接口的方法List<AppUser> GetUsersByCompanyId(Guid companyId)实现，不通过实体导航属性直接查询，这样Company类完全不需要依赖AppUser的定义，自然不存在跨层引用问题

注意：禁止为了临时解决问题让领域层引用API层，会彻底打破分层依赖规则，后续迭代维护成本会大幅提升。

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