.Net 6向MySQL LONGBLOB插入图片后列值为空的问题排查

问题场景 #

在.NET 6项目中，尝试向MySQL数据库的LONGBLOB类型列插入图片，实体类的Image属性为byte[]类型。调试时确认流内容不为空，调用SaveChangesAsync()也无报错，但数据库中的LONGBLOB列始终为空。相关接口代码如下：

[HttpPost]
public async Task<IActionResult> FotografEkle(string title, IFormFile image)
{
    if(title == null || image == null)
    {
        return View();
    } else
    {
        using (var stream = new MemoryStream())
        {
            await image.CopyToAsync(stream);
            Resimler resim = new Resimler
            {
                Name = title,
                Image = stream.ToArray(),
                MimeType = image.ContentType
            };
            context.Resimlers.Add(resim);
            await context.SaveChangesAsync();
            return View();
        }
    }
}

可能原因 #

• 实体映射不匹配：EF Core默认可能将byte[]映射为BLOB而非LONGBLOB，或者属性与数据库列名不匹配、被标记为忽略映射。
• 连接字符串配置缺失：未开启大数据传输权限，导致超过默认限制的字节数组被截断或丢弃。
• EF Core生成SQL异常：INSERT语句未包含Image字段，导致该列未被赋值。

解决办法 #

1. 修正实体类映射配置 #

确保实体属性与数据库列正确关联，并显式指定LONGBLOB类型：

方式一：使用数据注解

public class Resimler
{
    // 其他主键/基础属性
    public string Name { get; set; }
    
    [Column("Image")] // 确保与数据库列名一致
    [DataType("longblob")]
    public byte[] Image { get; set; }
    
    public string MimeType { get; set; }
}

方式二：使用Fluent API

在DbContext的OnModelCreating方法中添加映射规则：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Resimler>()
        .Property(r => r.Image)
        .HasColumnType("longblob")
        .IsRequired(false); // 根据业务需求设置是否必填
}

2. 调整MySQL连接字符串 #

添加大数据包支持的配置项（MaxAllowedPacket值可根据图片大小调整，示例为100MB）：

Server=your_server_address;Database=your_db_name;Uid=your_username;Pwd=your_password;AllowLoadLocalInfile=true;MaxAllowedPacket=104857600;

3. 验证EF Core生成的SQL语句 #

启用EF Core日志，查看INSERT语句是否包含Image字段：
在Program.cs中添加日志配置：

builder.Logging.AddFilter("Microsoft.EntityFrameworkCore.Database.Command", LogLevel.Information);

运行项目后查看控制台日志，确认INSERT语句中是否有Image列的赋值逻辑。如果缺失，检查实体类是否被正确扫描、属性是否被意外标记为[NotMapped]。

4. 确认流操作的完整性（可选） #

虽然MemoryStream.ToArray()不受流位置影响，但可以在复制后重置流位置做额外验证：

await image.CopyToAsync(stream);
stream.Position = 0; // 重置流指针到起始位置
var imageBytes = stream.ToArray();

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