ASP.NET Core脚手架生成的Create方法无法保存数据到MySQL的原因及排查

我正在为本科毕业设计开发一个基于ASP.NET Core MVC的项目，使用MySQL数据库，用于管理用户（学生、教师、管理员）及其角色。

模型代码 #

用户（Pouzivatel） #

public class Pouzivatel
{
    public int PouzivatelId { get; set; }
    public string Meno { get; set; }
    public string Email { get; set; }
    public int RolaId { get; set; }
    public Rola Rola { get; set; }
}

角色（Rola） #

public class Rola
{
    public int RolaId { get; set; }
    public string Nazov { get; set; }
    public ICollection<Pouzivatel> Pouzivatelia { get; set; }
}

DbContext代码 #

public class AplikaciaDbContext : DbContext
{
    public DbSet<Pouzivatel> Pouzivatelia { get; set; }
    public DbSet<Rola> Rola { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Rola>()
            .HasMany(r => r.Pouzivatelia)
            .WithOne(p => p.Rola)
            .HasForeignKey(p => p.RolaId);
    }
}

问题描述 #

通过Visual Studio脚手架生成了PouzivatelsController的CRUD操作，但尝试创建用户时，数据无法保存到数据库，也不会显示在列表视图中，且Visual Studio和日志中均无错误信息。

控制器Create方法代码 #

GET 请求 #

// GET: Pouzivatel/Create
public IActionResult Create()
{
    ViewData["RolaId"] = new SelectList(_context.Role, "RolaId", "Nazov");
    return View();
}

POST 请求 #

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(Pouzivatel pouzivatel)
{
    if (ModelState.IsValid)
    {
        _context.Add(pouzivatel);
        await _context.SaveChangesAsync();
        return RedirectToAction(nameof(Index));
    }

    ViewData["RolaId"] = new SelectList(_context.Role, "RolaId", "Nazov", pouzivatel.RolaId);
    return View(pouzivatel);
}

视图代码（Create.cshtml） #

@model Pouzivatel

<form asp-action="Create">
    <div class="form-group">
        <label asp-for="Meno" class="control-label"></label>
        <input asp-for="Meno" class="form-control" />
        <span asp-validation-for="Meno" class="text-danger"></span>
    </div>
    <div class="form-group">
        <label asp-for="Email" class="control-label"></label>
        <input asp-for="Email" class="form-control" />
        <span asp-validation-for="Email" class="text-danger"></span>
    </div>
    <div class="form-group">
        <label asp-for="RolaId" class="control-label"></label>
        <select asp-for="RolaId" class="form-control" asp-items="ViewBag.RolaId"></select>
        <span asp-validation-for="RolaId" class="text-danger"></span>
    </div>
    <button type="submit" class="btn btn-primary">Create</button>
</form>

排查与解决步骤 #

• 检查模型验证状态：在POST方法的if (ModelState.IsValid)之前添加代码，输出所有模型验证错误，比如：

  foreach (var error in ModelState.Values.SelectMany(v => v.Errors))
  {
      Console.WriteLine($"验证错误：{error.ErrorMessage}");
  }
  

  很多时候数据无法保存是因为模型验证不通过，但前端未显示完整错误（比如字段未填但模型未标记[Required]，数据库字段为非空导致验证失败）。

• 补充模型数据注解：给Pouzivatel的属性添加必要的验证标记，明确约束规则，同时让前端显示对应错误：

  public class Pouzivatel
  {
      public int PouzivatelId { get; set; }
      [Required(ErrorMessage = "姓名不能为空")]
      public string Meno { get; set; }
      [Required(ErrorMessage = "邮箱不能为空")]
      [EmailAddress(ErrorMessage = "邮箱格式不正确")]
      public string Email { get; set; }
      [Required(ErrorMessage = "请选择角色")]
      public int RolaId { get; set; }
      public Rola Rola { get; set; }
  }
  

• 验证数据库连接与迁移：

  • 确认appsettings.json中的MySQL连接字符串正确，指向目标数据库。
  • 检查是否已执行Add-Migration和Update-Database命令，确保数据库表结构与模型完全匹配（比如Meno、Email字段是否设置为非空，外键RolaId是否关联正确）。

• 捕获保存时的异常：在SaveChangesAsync处添加异常捕获，查看底层数据库错误：

  try
  {
      await _context.SaveChangesAsync();
      Console.WriteLine("数据保存成功");
  }
  catch (Exception ex)
  {
      Console.WriteLine($"保存失败：{ex.ToString()}");
  }
  

  可能存在外键约束错误（比如选择的RolaId在数据库中不存在）、字段长度超出限制等问题。

• 检查表单数据绑定：在POST方法开头打印接收的pouzivatel属性值，确认表单提交的数据是否正确传递到后台：

  Console.WriteLine($"姓名：{pouzivatel.Meno}，邮箱：{pouzivatel.Email}，角色ID：{pouzivatel.RolaId}");
  

  若属性值为空，需检查视图中asp-for生成的表单字段是否正确，或者下拉列表是否有有效选项。

• 确认DbContext注入正确：检查Program.cs中是否正确注册了AplikaciaDbContext，并使用MySQL驱动：

  builder.Services.AddDbContext<AplikaciaDbContext>(options =>
      options.UseMySql(builder.Configuration.GetConnectionString("DefaultConnection"), 
          ServerVersion.AutoDetect(builder.Configuration.GetConnectionString("DefaultConnection"))));
  

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