.NET Core 6 WebAPI如何上传IFormFile到SQL VarBinary（含AutoMapper）

一、实现路径确认 #

你的方向是正确的：将IFormFile转为字节数组后存入SQL Server的VARBINARY(MAX)字段，这是存储小文件到数据库的常规方案（若为大文件，更推荐FILESTREAM或外部存储，小文件场景下当前方案完全可行）。

二、模型定义梳理 #

先明确三类核心模型（按常规分层架构）：

1. 请求DTO：接收前端上传数据，包含IFormFile属性

public class ConcessionDocumentRequestDto
{
    public IFormFile File { get; set; }
    // 其他业务字段示例
    public string DocumentName { get; set; }
    public string DocumentType { get; set; }
}

2. EF实体模型：对应数据库表，字节数组属性映射VARBINARY(MAX)

public class ConcessionDocument
{
    public int Id { get; set; }
    public byte[] FileContent { get; set; } // 映射数据库VARBINARY(MAX)字段
    public string DocumentName { get; set; }
    public string DocumentType { get; set; }
    public DateTime UploadTime { get; set; }
}

3. 响应DTO（可选）：返回前端的元数据模型，无需包含字节数组

public class ConcessionDocumentResponseDto
{
    public int Id { get; set; }
    public string DocumentName { get; set; }
    public string DocumentType { get; set; }
    public DateTime UploadTime { get; set; }
}

三、AutoMapper映射配置 #

AutoMapper无法直接完成IFormFile到byte[]的默认映射，需添加自定义转换逻辑：

1. 创建AutoMapper配置类，定义映射规则及转换方法

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap<ConcessionDocumentRequestDto, ConcessionDocument>()
            // 自定义File到FileContent的转换逻辑
            .ForMember(dest => dest.FileContent, opt => opt.MapFrom(src => ConvertFileToBytes(src.File)));
        
        // 可选：实体到响应DTO的映射
        CreateMap<ConcessionDocument, ConcessionDocumentResponseDto>();
    }

    // 辅助方法：将IFormFile转为字节数组
    private byte[] ConvertFileToBytes(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return null;

        using var memoryStream = new MemoryStream();
        file.CopyTo(memoryStream);
        return memoryStream.ToArray();
    }
}

2. 在Program.cs中注册AutoMapper

builder.Services.AddAutoMapper(typeof(MappingProfile));

四、POST接口实现 #

在控制器中注入IMapper和EF上下文，处理上传请求：

[ApiController]
[Route("api/concession-documents")]
public class ConcessionDocumentsController : ControllerBase
{
    private readonly AppDbContext _dbContext;
    private readonly IMapper _mapper;

    public ConcessionDocumentsController(AppDbContext dbContext, IMapper mapper)
    {
        _dbContext = dbContext;
        _mapper = mapper;
    }

    [HttpPost]
    public async Task<IActionResult> Upload([FromForm] ConcessionDocumentRequestDto requestDto)
    {
        // 基础校验
        if (requestDto.File == null || requestDto.File.Length == 0)
            return BadRequest("请选择有效文件");

        // 用AutoMapper完成DTO到EF实体的映射
        var documentEntity = _mapper.Map<ConcessionDocument>(requestDto);
        documentEntity.UploadTime = DateTime.UtcNow;

        // 写入数据库
        _dbContext.ConcessionDocuments.Add(documentEntity);
        await _dbContext.SaveChangesAsync();

        // 返回响应DTO
        var responseDto = _mapper.Map<ConcessionDocumentResponseDto>(documentEntity);
        return CreatedAtAction(nameof(GetById), new { id = responseDto.Id }, responseDto);
    }

    // 可选：根据ID获取文档元数据或下载文件
    [HttpGet("{id}")]
    public async Task<IActionResult> GetById(int id)
    {
        var document = await _dbContext.ConcessionDocuments.FindAsync(id);
        if (document == null)
            return NotFound();

        // 若需返回文件下载：
        // return File(document.FileContent, document.DocumentType, document.DocumentName);
        
        // 返回元数据
        var responseDto = _mapper.Map<ConcessionDocumentResponseDto>(document);
        return Ok(responseDto);
    }
}

五、额外注意事项 #

• 文件大小限制：默认.NET Core限制上传文件为30MB，如需更大文件，在Program.cs中配置：

builder.Services.Configure<Microsoft.AspNetCore.Http.Features.FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 104857600; // 100MB
});

• 数据库字段校验：确保EF实体的FileContent属性正确映射VARBINARY(MAX)，可通过数据注解或Fluent API实现：

// 数据注解方式
[Column(TypeName = "varbinary(max)")]
public byte[] FileContent { get; set; }

// Fluent API方式（在DbContext的OnModelCreating方法中）
modelBuilder.Entity<ConcessionDocument>()
    .Property(x => x.FileContent)
    .HasColumnType("varbinary(max)");

• 性能优化：若文件超过10MB，建议改用SQL Server FILESTREAM功能，或将文件存储至本地/云存储，数据库仅保存文件路径，提升读写效率。

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