ASP.NET Core 5更新文本字段时出现未处理异常如何解决

在ASP.NET Core中改造Edit编辑动作方法，实现按需更新字段的能力，当前支持更新的字段共2个：文件名、图片文件。测试验证结果如下：

• 仅更新图片文件：功能运行正常
• 同时更新图片文件+文件名：功能运行正常
• 仅更新文件名字段：抛出未处理异常

[HttpPost]
[ValidateAntiForgeryToken]
//public async Task<IActionResult> Edit([Bind("ImgID,Title,ImageFile")] IFormFile fileobj, imageModels imgModels, string fileName, int id)
public async Task<IActionResult> Edit(imageModels imgModels, int id, IFormFile ImageFile)
{
    var imageModels = await _context.Images.FindAsync(id);

    if (ImageFile != null)
    {
        
        var imagePath = Path.Combine(_hostEnvironment.WebRootPath, "images", imageModels.ImgName);
        if (System.IO.File.Exists(imagePath))
            System.IO.File.Delete(imagePath);
        _context.Images.Remove(imageModels);
    
        string wwwRootPath = _hostEnvironment.WebRootPath;
        string fileName = Path.GetFileNameWithoutExtension(imgModels.ImageFile.FileName);
        string extension = Path.GetExtension(imgModels.ImageFile.FileName);
        imgModels.ImgName = fileName = fileName + DateTime.Now.ToString("yymmssfff") + extension;
        string path = Path.Combine(wwwRootPath + "/images/", fileName);
        using (var fileStream = new FileStream(path, FileMode.Create))
        {
            //await imgModels.ImageFile.CopyToAsync(fileStream);
            imgModels.ImageFile.CopyTo(fileStream);
        }

    }

    _context.Update(imgModels);
    await _context.SaveChangesAsync();
    return RedirectToAction(nameof(Index));
    //return View(imgModels);
}

核心问题有3个：

1. EF Core实体跟踪冲突：先通过FindAsync查出主键匹配的实体并被上下文跟踪，后续不管是否上传新文件，都直接调用_context.Update(imgModels)尝试跟踪前端传入的同主键实体。仅更新文件名时，上传文件判断分支不执行，查出的原实体还保持Unchanged跟踪状态，此时上下文同时存在两个同主键同类型的实体，直接抛出跟踪冲突异常。
2. 错误的数据库操作逻辑：编辑场景下替换图片不需要删除原数据库记录，上传新文件分支里调用_context.Images.Remove(imageModels)属于完全多余的操作，反而会引入状态不一致问题，之前两种场景不报错只是巧合。
3. 变量命名混淆：数据库查出的实体变量名imageModels和传入参数imgModels高度相似，极易出现引用写错的问题，比如分支内引用imgModels.ImageFile完全可以直接用方法参数ImageFile。

修复逻辑遵循几个原则：所有字段更新都基于数据库查出的跟踪实体修改，不直接全量Update传入模型；仅在有新文件上传时才处理物理文件替换，不操作数据库删除；按需更新对应字段，避免无关字段被空值覆盖。

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Edit(imageModels imgModels, int id, IFormFile ImageFile)
{
    // 先查询要更新的原实体，不存在直接返回404
    var existingImage = await _context.Images.FindAsync(id);
    if (existingImage == null)
    {
        return NotFound();
    }

    // 按需更新文件名字段，避免空值覆盖
    if (!string.IsNullOrWhiteSpace(imgModels.Title))
    {
        existingImage.Title = imgModels.Title;
    }

    // 仅当有新图片上传时，才处理文件替换逻辑
    if (ImageFile != null)
    {
        // 删除原有物理图片文件
        var oldImagePath = Path.Combine(_hostEnvironment.WebRootPath, "images", existingImage.ImgName);
        if (System.IO.File.Exists(oldImagePath))
        {
            System.IO.File.Delete(oldImagePath);
        }

        // 保存新上传的图片
        string wwwRootPath = _hostEnvironment.WebRootPath;
        string fileBaseName = Path.GetFileNameWithoutExtension(ImageFile.FileName);
        string extension = Path.GetExtension(ImageFile.FileName);
        string newStoredFileName = fileBaseName + DateTime.Now.ToString("yymmssfff") + extension;
        string newFilePath = Path.Combine(wwwRootPath, "images", newStoredFileName);
        using (var fileStream = new FileStream(newFilePath, FileMode.Create))
        {
            await ImageFile.CopyToAsync(fileStream);
        }

        // 更新实体里存储的文件名，不需要删除数据库记录
        existingImage.ImgName = newStoredFileName;
    }

    // 不需要显式调用Update，修改被跟踪实体的字段后，SaveChanges会自动持久化变更
    await _context.SaveChangesAsync();
    return RedirectToAction(nameof(Index));
}

注意：代码里的Title字段对应要更新的文件名字段，如果你的模型里文件名字段属性名不是Title，替换成实际属性名即可。

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