JSON列单元测试可更新，MVC控制器无法更新的问题排查

问题核心 #

单元测试中从EF上下文获取的Employee实体，更新JSON类型的Phones属性后能正常同步到数据库；但MVC控制器中通过ModelBinding得到的Employee实体，调用同样的UpdatePhones方法后，Phones列不会出现在SQL Update语句中，其他标量属性（如FirstName）可正常更新。

原因分析 #

1. 单元测试场景：Employee实体是通过仓库Get方法从数据库获取的，EF上下文全程跟踪该实体状态。调用UpdatePhones修改Phones集合时，EF的变更检测能识别到复杂类型（JSON列）的内部变化，因此生成的Update语句包含Phone字段。
2. 控制器场景：model.Employee是ModelBinding创建的全新对象，不属于EF上下文的跟踪范围。在UpdateEmployeeAsync中执行Attach并设置EntityState.Modified时，EF仅会将标量属性标记为需要更新；对于Phones这种复杂类型（集合/JSON序列化属性），EF默认不会检测其内部的内容变化——它跟踪的是实体属性的引用，而非内部集合的元素变更。此时EF认为Phones的"原始值"和"当前值"一致，因此不会将其加入Update语句。

解决方案 #

方案1：重新获取实体并更新（已验证可行） #

从数据库重新加载EF跟踪的Employee实体，将ViewModel中的属性（包括修改后的Phones）赋值给该实体，再保存。这样EF能正确检测到Phones的变更：

[HttpPost, ValidateAntiForgeryToken]
public async Task<IActionResult> Save(EditEmployeeViewModel model)
{
    // 重新获取EF跟踪的实体
    var dbEmployee = (await _employeeRepository.Get(emp => emp.Id == model.Employee.Id)).Single();
    
    // 更新标量属性
    dbEmployee.FirstName = model.Employee.FirstName;
    dbEmployee.LastName = model.Employee.LastName;
    // 更新Phones属性
    dbEmployee.UpdatePhones(new List<StringValue> { "888" });
    
    await _employeeRepository.UpdateEmployeeAsync(dbEmployee);
    return RedirectToAction("Index");
}

方案2：手动标记Phones属性为Modified #

在Attach实体后，显式告诉EFPhones属性已变更，强制其加入Update语句：
修改UpdateEmployeeAsync方法：

public async Task UpdateEmployeeAsync(Employee employee)
{
    dbContext.Employees.Attach(employee);
    var entry = dbContext.Entry<Employee>(employee);
    entry.State = EntityState.Modified;
    // 手动标记Phones属性为已修改
    entry.Property(e => e.Phones).IsModified = true;
    await dbContext.SaveChangesAsync();
}

方案3：调整实体跟踪时机 #

先Attach实体让EF跟踪，再修改属性，确保EF能捕捉到变更：

[HttpPost, ValidateAntiForgeryToken]
public async Task<IActionResult> Save(EditEmployeeViewModel model)
{
    // 先Attach让EF跟踪实体
    _dbContext.Employees.Attach(model.Employee);
    // 再修改Phones属性
    model.Employee.UpdatePhones(new List<StringValue> { "888" });
    
    var entry = _dbContext.Entry(model.Employee);
    entry.State = EntityState.Modified;
    await _dbContext.SaveChangesAsync();
    
    return RedirectToAction("Index");
}

关键注意点 #

• EF Core对于复杂类型/集合类型的变更检测依赖于实体是否被上下文跟踪，以及属性的引用是否发生变化。如果只是修改集合内部元素而非替换整个集合，EF默认不会自动检测到变化。
• 当使用EntityState.Modified时，EF会生成包含所有标量属性的Update语句，但复杂类型需要显式标记或确保上下文能跟踪其变化。

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