ASP.NET Core中EF Core Code-First存文件至SQL Server报错求助

这个错误的核心原因很明确：EF把你的Avatar字段误识别成了导航属性（也就是关联其他实体的属性），但你试图用Property()方法去配置它——而Property()只能用来配置标量属性（比如byte[]、string这类直接存在数据库字段里的类型）。下面分步骤帮你修复：

第一步：确认实体类的Avatar定义是标量属性 #

首先检查你的UserProfile实体，确保Avatar是用来存文件字节的标量类型，而不是另一个实体类的实例（那会被EF当成导航属性）。

错误的定义（会被识别为导航属性）：

public class UserProfile
{
    public int Id { get; set; }
    // 这里Avatar是一个实体类，EF会认为是导航属性
    public Avatar Avatar { get; set; } 
}

正确的定义（标量属性，用于存储文件）：

public class UserProfile
{
    public int Id { get; set; }
    // 用byte[]存储文件的字节数组
    public byte[] Avatar { get; set; }
    // 可选：存储文件的MIME类型，方便后续读取时识别
    public string AvatarContentType { get; set; }
}

第二步：修正Fluent API的配置逻辑 #

如果之前你不小心用了导航属性的配置方法（比如HasOne/WithOne），现在要改成针对标量属性的FileStream配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<UserProfile>()
        .Property(u => u.Avatar)
        .HasColumnType("VARBINARY(MAX)") // 指定数据库字段类型
        .IsRequired(false) // 根据需求设置是否必填
        .HasAnnotation("SqlServer:IsFileStream", true); // 启用SQL Server FileStream特性
}

如果你更喜欢用数据注解而非Fluent API，也可以直接在实体属性上标记：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.SqlServer;

public class UserProfile
{
    public int Id { get; set; }
    
    [Column(TypeName = "VARBINARY(MAX)")]
    [SqlServerIsFileStream] // 启用FileStream
    public byte[] Avatar { get; set; }
    
    public string AvatarContentType { get; set; }
}

第三步：确保SQL Server已启用FileStream #

这是容易忽略的前提：你的SQL Server实例必须先启用FileStream功能，并且数据库要配置对应的FileStream文件组。

启用FileStream功能 #

1. 打开SQL Server配置管理器
2. 找到你的SQL Server实例，右键→属性→FileStream选项卡
3. 勾选"启用Transact-SQL访问"，按需勾选其他访问级别

创建带FileStream文件组的数据库（如果还没创建） #

执行以下SQL脚本创建支持FileStream的数据库：

CREATE DATABASE UserProfileDB
ON PRIMARY (NAME = UserProfileDB_Primary, FILENAME = 'C:\SQLData\UserProfileDB.mdf'),
FILEGROUP FileStreamGroup CONTAINS FILESTREAM (NAME = UserProfileDB_FileStream, FILENAME = 'C:\SQLData\UserProfileDB_FileStream')
LOG ON (NAME = UserProfileDB_Log, FILENAME = 'C:\SQLData\UserProfileDB.ldf');

最后：执行数据库迁移 #

修正实体和配置后，运行EF迁移命令更新数据库：

Add-Migration AddAvatarFileStream
Update-Database

这样就能正确把文件通过FileStream存储到SQL Server里了。

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