EF Core更新用户时出现Value cannot be null (Parameter 'entity') 500错误

错误核心原因 #

报错Value cannot be null. (Parameter 'entity')是因为调用UserRepository.Update(user)时传入的user为null，最终导致_context.Entry(user)无法处理空实体。追根溯源，是控制器中var user = await _userRepository.GetUserByUsernameAsync(username);这行代码返回了null。

具体诱因及修复方案 #

1. 身份认证环节未正确获取用户名 #

控制器通过claimsIdentity.Name拿用户名，但如果请求未携带有效认证信息，或者claimsIdentity本身为null，会导致username为空，查询自然返回null。

修复步骤：

• Postman测试时，务必在请求头添加Authorization: Bearer {你的JWT Token}，确保请求已认证
• 给UpdateUser方法加上[Authorize]特性，强制只有认证用户才能访问：

[HttpPut]
[Authorize]
public async Task<ActionResult> UpdateUser(MemberUpdateDto memberUpdateDto)
{
    // 原有代码逻辑
}

• 在获取用户名前增加空值校验，提前返回明确错误：

var claimsIdentity = User.Identity as System.Security.Claims.ClaimsIdentity;
if (claimsIdentity == null || string.IsNullOrEmpty(claimsIdentity.Name))
{
    return Unauthorized("无法获取有效用户身份信息");
}
var username = claimsIdentity.Name;

2. 数据库中无匹配用户名的用户 #

GetUserByUsernameAsync(username)查询不到对应用户，直接返回null，后续调用Update触发异常。

修复步骤：

• 核对Postman请求的认证用户是否存在于数据库中
• 查询用户后立即做空值检查，避免后续逻辑执行：

var user = await _userRepository.GetUserByUsernameAsync(username);
if (user == null)
{
    return NotFound("未找到目标用户");
}

3. 用户查询方法逻辑错误 #

如果GetUserByUsernameAsync的查询逻辑有问题（比如大小写敏感、查询字段错误），也会导致查不到用户。

修复步骤：

• 检查UserRepository中该方法的实现，建议用不区分大小写的匹配：

public async Task<AppUser> GetUserByUsernameAsync(string username)
{
    return await _context.Users.FirstOrDefaultAsync(u => 
        u.UserName.Equals(username, StringComparison.OrdinalIgnoreCase));
}

额外防御性优化 #

在UserRepository.Update方法中增加空值校验，提前抛出明确异常，方便排查：

public void Update(AppUser user)
{
    ArgumentNullException.ThrowIfNull(user, nameof(user));
    _context.Entry(user).State = EntityState.Modified;
}

内容的提问来源于stack exchange，提问作者Bui Quang Vu