ASP.NET+EF添加用户时关联UserInfo表避免循环引用问题求助

我刚开始学习ASP.NET和Entity Framework，编写了一个Post接口用于添加新用户，同时希望向包含user_id外键的UserInfo表（存储姓名等信息）插入数据。我认为在执行_context.Users.Add(user)后用户实例被赋值，造成了循环引用。我想了解如何正确实现关联添加UserInfo表数据的方式，我知道可以用Newtonsoft.Json.ReferenceLoopHandling.Ignore规避，但觉得这并非正确做法。

public async Task<ActionResult<User>> PostUser(ReqUser user)
{
    if (_context.Users == null)
    {
        return Problem("Entity set 'MatrixContext.Users'  is null.");
    }
    if (!ValidEmail(user.Username))
    {
        return BadRequest("Invalid email");
    }
    if (!string.IsNullOrEmpty(user.Code))
    {
        user.ValidCode = ValidCode(user.Code);
        if ((bool)!user.ValidCode)
        {
            var com = new Companion();
            com.MainUserId = user.Id;
            //这里根据代码（大概率是桌号）来赋值table_id
            await _context.Companions.AddAsync(com);
        }
    }
    //user.Password = Convert.ToString(user.Password.GetHashCode()); 密码哈希
    _context.Users.Add(user);
    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateException)
    {
        if (UserExists(user.Id))
        {
            return Conflict();
        }
        else
        {
            throw;
        }
    }
    UserInfo userInfo = new UserInfo { CreatedAt = DateTime.Today, Name = user.Name, Surname = user.Surname, Code = user.Code, UserId = user.Id };
    _context.UserInfos.Add(userInfo);
    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateException)
    {
            return Conflict();
    }
    //user.ValidCode = !ValidCode(user.Code);
    return CreatedAtAction("GetUser", new { id = user.Id }, user);
}

1. 利用实体导航属性一次性保存 #

首先确保User和UserInfo实体已定义关联的导航属性：

public class User
{
    // 基础属性（如Id、Username等）
    public int Id { get; set; }
    public string Username { get; set; }

    // 一对一导航属性
    public UserInfo UserInfo { get; set; }
}

public class UserInfo
{
    // 基础属性
    public int Id { get; set; }
    public DateTime CreatedAt { get; set; }
    public string Name { get; set; }
    public string Surname { get; set; }

    // 外键属性
    public int UserId { get; set; }
    // 反向导航属性
    public User User { get; set; }
}

修改接口逻辑，直接关联实体并合并保存操作：

public async Task<ActionResult<UserResponseDto>> PostUser(ReqUser userDto)
{
    if (_context.Users == null)
    {
        return Problem("Entity set 'MatrixContext.Users' is null.");
    }
    if (!ValidEmail(userDto.Username))
    {
        return BadRequest("Invalid email");
    }

    // 构建User实体并关联UserInfo
    var user = new User
    {
        Username = userDto.Username,
        Password = BCrypt.Net.BCrypt.HashPassword(userDto.Password), // 正确的密码哈希方式
        UserInfo = new UserInfo
        {
            CreatedAt = DateTime.Today,
            Name = userDto.Name,
            Surname = userDto.Surname,
            Code = userDto.Code
        }
    };

    if (!string.IsNullOrEmpty(userDto.Code))
    {
        user.ValidCode = ValidCode(userDto.Code);
        if (!user.ValidCode.Value)
        {
            var companion = new Companion
            {
                MainUserId = user.Id // 无需手动赋值，SaveChanges后EF会自动填充
            };
            _context.Companions.Add(companion);
        }
    }

    _context.Users.Add(user);
    try
    {
        await _context.SaveChangesAsync(); // 一次保存，EF自动处理外键关联
    }
    catch (DbUpdateException)
    {
        if (UserExists(user.Id))
        {
            return Conflict();
        }
        throw;
    }

    // 用DTO返回数据，避免循环引用
    var responseDto = new UserResponseDto
    {
        Id = user.Id,
        Username = user.Username,
        Name = user.UserInfo.Name,
        Surname = user.UserInfo.Surname
    };

    return CreatedAtAction("GetUser", new { id = user.Id }, responseDto);
}

2. 从根源避免循环引用：使用DTO返回数据 #

循环引用的本质是你直接返回了包含导航属性的EF实体，JSON序列化时会递归遍历User.UserInfo和UserInfo.User。正确做法是永远不要直接返回EF实体给前端，定义专门的DTO（数据传输对象），只包含前端需要的字段，彻底切断循环引用的可能。

3. 优化保存逻辑：减少SaveChanges调用 #

原代码调用了两次SaveChangesAsync，完全可以合并为一次。EF会自动处理实体间的外键依赖，先插入User生成Id，再自动填充UserInfo的UserId并插入。

4. 密码哈希的正确实现 #

原代码注释的GetHashCode()不能用于密码哈希（哈希值不稳定且安全性极低），应使用专业的哈希库如BCrypt.Net，或者ASP.NET Core Identity自带的PasswordHasher。

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