ASP.NET Core Web API发起POST请求后MySQL Workbench无数据更新

前提：基础连通性验证正常（如GET请求可正常拉取数据、服务启动无数据库连接报错），按以下优先级从高到低排查：

• 检查持久化方法是否真的调用
  • 若使用Entity Framework Core：确认添加实体后是否执行了await _context.SaveChangesAsync()（或同步方法_context.SaveChanges()），不少人只写了_context.Set<T>().Add(entity)就直接返回200响应，根本没触发实际入库操作；如果手动开了事务，检查是否漏了transaction.Commit()，或事务中途抛异常触发回滚但异常被吞了没打日志。
  • 若使用Dapper/原生ADO.NET：确认写入操作调用的是ExecuteAsync()/Execute()这类执行方法，不是拿QueryAsync去跑INSERT语句；原生ADO.NET场景下确认MySqlCommand调用了ExecuteNonQuery()，别只拼接SQL不执行。
• 核对连接的数据库实例、库名是否匹配
  先在接口中打印当前数据库连接的DataSource（实例地址）、Database（库名）属性，和你MySQL Workbench中连接的实例、选中的库做比对。多环境开发时很容易出现接口连本地测试库、人去远程库查数据的低级错误；同时检查连接串是否漏写Database=xxx参数，导致连接到MySQL默认系统库，数据写进了错误的表。
• 确认请求是否真的走到了数据库写入逻辑
  • 先看POST接口返回的状态码：如果是400 Bad Request，说明[ApiController]的模型校验没通过，请求在进入业务逻辑前就被拦截了——大多是前端传的字段名/类型和实体不匹配、非空字段没传值，根本没走到写库步骤。
  • 在写入逻辑的第一行加断点/打调试日志，确认请求能走到这一步，同时看传入的实体属性值有没有异常，比如必填字段是null、字段长度超过数据库定义的长度。
  • 检查全局异常处理逻辑，有没有把MySQL抛出的约束冲突、外键错误、权限不足这类异常直接吞掉，返回统一的200响应，导致你以为写入成功了。
• 检查ORM映射配置是否正确
  • 若用EF Core，检查要写入的属性有没有被[NotMapped]特性或FluentAPI的Ignore()配置排除在映射外。
  • 核对实体映射的表名和你查询的表名完全一致：Linux环境下MySQL表名大小写敏感，比如实体默认映射User表，你去查users表自然找不到数据。
  • 检查有没有配置全局查询过滤器（比如软删除过滤器HasQueryFilter(x => !x.IsDeleted)），如果写入时不小心给IsDeleted赋了true，常规查询不加IgnoreQueryFilters()是查不到这条数据的。
• 从数据库侧反向验证
  临时开启MySQL通用查询日志，确认INSERT语句有没有真的发到数据库（临时开日志重启服务就失效，不影响性能）：

  SET GLOBAL general_log = 'ON';
  SET GLOBAL log_output = 'TABLE';
  

  触发一次POST请求后，查询日志看有没有对应的INSERT语句：

  SELECT event_time, argument FROM mysql.general_log WHERE argument LIKE '%INSERT%' ORDER BY event_time DESC LIMIT 10;
  

  • 如果日志里完全没出现对应的INSERT语句：问题在应用层，回到前面的步骤检查逻辑有没有执行到写入操作。
  • 如果日志里有INSERT语句，把语句复制出来手动在Workbench里执行，就能直接看到是主键冲突、外键约束、字段不匹配还是账号权限问题。
    额外提一句：确认你Workbench登录的账号有对应表的SELECT权限，极少数情况会出现写入成功但查询账号没权限看不到数据的问题。
• 检查框架层拦截逻辑
  • 如果你用了工作单元（UnitOfWork）模式，检查是不是靠ActionFilter统一触发SaveChanges，而你的POST接口方法没加对应特性，导致请求结束后没触发提交。
  • 如果项目配了读写分离，确认写入走主库后，你查询连的是不是刚写完的主库，不要刚写完就去连同步有延迟的从库查数据。

快速定位技巧：在你认为的写入逻辑执行完成后，立刻用同一个数据库连接查一次刚插入的主键对应的数据，把结果返回给前端。如果接口返回能查到这条数据，但Workbench里查不到，100%是连错库/表、事务没提交的问题；如果接口里都查不到，说明写入操作根本没执行成功。

内容的提问来源于stack exchange，提问作者Dubem.Dev