使用Pomelo MySQL Provider向MariaDB插入TIMESTAMP字段值为空问题排查

问题场景 #

使用Pomelo EF Core Provider（已尝试新旧版本）操作MariaDB 10.1.48-MariaDB-0+deb9u2时，出现异常情况：

• 测试表Testtabel包含3个字段：
  • ID（INT，自增）
  • created_date_time（DATETIME）
  • created_timestamp（TIMESTAMP）
• 通过EF Core代码插入数据后，created_timestamp字段值为空：

Testtabel.Add(new Testtabel(){
    CreatedDateTime = DateTime.Now,
    CreatedTimestamp = DateTime.Now
});
SaveChanges();

• 但直接使用Pomelo依赖的MySqlConnector库插入数据，created_timestamp字段值完全正常：

using var connection = new MySqlConnection("Server=xxxx;User ID=xxxx;Password=xxxx;Database=xxxx");
connection.Open();

using (var cmd = new MySqlCommand())
{
    cmd.Connection = connection;
    cmd.CommandText = "INSERT INTO testtabel_sync (created_date_time, created_timestamp) VALUES (@dt, @ts)";
    cmd.Parameters.AddWithValue("dt", DateTime.Now);
    cmd.Parameters.AddWithValue("ts", DateTime.Now);
    await cmd.ExecuteNonQueryAsync();
}

using var command = new MySqlCommand("SELECT * FROM testtabel_sync;", connection);
using var reader = command.ExecuteReader();
reader.Dump();

可能原因与解决办法 #

1. 实体映射配置问题 #

先检查实体类的CreatedTimestamp属性是否正确映射到数据库字段：

• 确保实体属性类型为DateTime（而非可空的DateTime?），如果数据库字段是非空约束的话。
• 通过Fluent API显式指定字段类型与名称，避免映射歧义：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Testtabel>()
        .Property(t => t.CreatedTimestamp)
        .HasColumnType("timestamp")
        .HasColumnName("created_timestamp")
        .IsRequired();
}

2. 检查EF生成的SQL语句 #

开启EF Core日志，查看生成的INSERT语句是否包含created_timestamp字段：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
}

如果INSERT语句中未包含该字段，说明EF未识别到属性需要插入——可能是属性被标记为[NotMapped]，或者配置了DatabaseGeneratedOption.Identity/Computed导致EF跳过插入。

3. 连接字符串参数调整 #

检查连接字符串是否包含影响时间类型处理的参数，尝试添加或调整：

• UseLegacyDateTimeHandling=false：禁用旧版时间处理逻辑，避免TIMESTAMP映射异常
• ConvertZeroDateTime=true：允许将0时间转换为DateTime.MinValue，避免插入无效时间被截断

示例连接字符串：

Server=xxxx;User ID=xxxx;Password=xxxx;Database=xxxx;UseLegacyDateTimeHandling=false;ConvertZeroDateTime=true

4. 排除数据库字段默认行为冲突 #

确认数据库表的created_timestamp字段没有设置DEFAULT NULL或冲突的ON UPDATE CURRENT_TIMESTAMP规则。虽然直接用MySqlConnector插入正常，但EF的插入逻辑可能与字段默认设置产生交互，可临时修改字段为无默认值的非空TIMESTAMP再测试。

总结 #

这类问题大多源于EF Core与Pomelo对TIMESTAMP类型的映射配置差异，优先排查实体映射和生成的SQL语句，再调整连接字符串参数即可解决。

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