ASP.NET Core图片上传ModelState验证失败排查求助

问题根源 #

你的UniversityDto中UniversityImage字段标记了[Required]必填属性，但表单提交时：

• 前端input的name是file，对应控制器的IFormFile file参数，没有给universityDto的UniversityImage传递任何值
• 后端验证模型时，UniversityImage为空字符串，触发必填校验规则，直接导致ModelState.IsValid返回false

解决方案 #

方案1：移除不必要的必填验证（推荐） #

UniversityImage是后端通过上传文件路径拼接生成的，不需要前端传入，直接移除该字段的[Required]属性：

public record UniversityDto
{
    public int UniversityId { get; init; }

    [Required(ErrorMessage = "UniversityName is Required")]
    public string UniversityName { get; init; }

    [Required(ErrorMessage = "UniversityDescription is Required")]
    public string UniversityDescription { get; init; }

    [Required(ErrorMessage = "UniversityAddress is Required")]
    public string UniversityAddress { get; init; }

    [Required(ErrorMessage = "UniversityWebAddress is Required")]
    public string UniversityWebAddress { get; init; }

    [Required(ErrorMessage = "UniversityPhone is Required")]
    public string UniversityPhone { get; init; }

    // 移除[Required]，该字段由后端生成赋值
    public string UniversityImage { get; set; }
}

方案2：保留必填验证，手动清除模型错误 #

如果业务上必须保留[Required]，可以在控制器验证前手动清除该字段的验证错误：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create([FromForm] UniversityDtoForInsertion universityDto, IFormFile file)
{
    // 清除UniversityImage的验证错误，后续由后端赋值
    ModelState.Remove(nameof(universityDto.UniversityImage));
    
    if (ModelState.IsValid)
    {
        string path = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "images", file.FileName);

        await using (var stream = new FileStream(path, FileMode.Create))
        {
            await file.CopyToAsync(stream);
        }
        universityDto.UniversityImage = String.Concat("/images/", file.FileName);
        _serviceManager.UniversityService.CreateUniversity(universityDto);
        TempData["success"] = $"{universityDto.UniversityName} has been created.";
        return RedirectToAction("Index");
    }
    return View();
}

前端语义化优化（可选） #

前端label使用了asp-for="UniversityImage"，但实际绑定的是file输入框，可调整label文本保证语义一致：

<div class="form-group my-3">
    <label>University Image</label>
    <input name="file" type="file" class="form-control" />
</div>

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