如何避免应用层依赖IFormFile？清洁架构下的DTO优化方案

你遇到的问题很典型——既要保持应用层的独立性，又不想拆分DTO导致接口不直观。下面是几种更优的解决方案：

方案1：定义Web层专用的DTO（最简洁） #

核心思路是把和Web框架绑定的部分隔离在基础设施层（Web项目），应用层只保留纯业务数据的DTO：

应用层核心DTO（无框架依赖） #

public class SiteSettingsCoreDto
{
    public long Color1 { get; set; }
    public long Color2 { get; set; }
    public string CompetitionName { get; set; }
}

Web层专用DTO（继承核心DTO+新增IFormFile） #

// 放在Web项目中，仅用于接收前端请求
public class SiteSettingsWebDto : SiteSettingsCoreDto
{
    public IFormFile File { get; set; }
}

控制器代码 #

public async Task<ActionResult> AddSettings([FromForm]SiteSettingsWebDto webDto)
{
    // 将Web层DTO映射到应用层核心DTO
    var coreDto = new SiteSettingsCoreDto
    {
        Color1 = webDto.Color1,
        Color2 = webDto.Color2,
        CompetitionName = webDto.CompetitionName
    };
    
    // 单独传递文件给应用层服务
    await _siteSettingsService.SaveSettings(coreDto, webDto.File);
    return Ok();
}

这种方式既保证了应用层不依赖AspNetCore框架，又能让前端一次性提交所有数据，符合DTO的封装初衷。

方案2：用抽象接口隔离框架依赖（符合依赖倒置） #

如果想让应用层DTO也能包含文件相关信息，但又不想依赖框架，可以在应用层定义抽象的文件接口，Web层做适配：

应用层定义抽象文件接口 #

public interface IAppFile
{
    string FileName { get; }
    Stream OpenReadStream();
    // 按需添加其他属性，比如ContentLength、ContentType等
}

应用层DTO（依赖自有的抽象） #

public class SiteSettingsDto
{
    public long Color1 { get; set; }
    public long Color2 { get; set; }
    public string CompetitionName { get; set; }
    public IAppFile File { get; set; }
}

Web层实现适配器（把IFormFile转成IAppFile） #

public class FormFileAdapter : IAppFile
{
    private readonly IFormFile _formFile;
    
    public FormFileAdapter(IFormFile formFile) => _formFile = formFile;

    public string FileName => _formFile.FileName;
    public Stream OpenReadStream() => _formFile.OpenReadStream();
}

控制器代码 #

public async Task<ActionResult> AddSettings([FromForm]SiteSettingsDto dto, IFormFile image)
{
    // 适配文件对象到应用层抽象
    dto.File = new FormFileAdapter(image);
    await _siteSettingsService.SaveSettings(dto);
    return Ok();
}

如果觉得手动适配麻烦，还可以写个自定义模型绑定器，让框架自动把IFormFile绑定到IAppFile，这样控制器里只需要接收SiteSettingsDto即可。

方案3：直接传递文件内容（适合小文件） #

如果文件体积不大，可以在控制器里把IFormFile转换成byte[]，传给应用层DTO：

应用层DTO #

public class SiteSettingsDto
{
    public long Color1 { get; set; }
    public long Color2 { get; set; }
    public string CompetitionName { get; set; }
    public byte[] FileContent { get; set; }
    public string FileName { get; set; }
}

控制器代码 #

public async Task<ActionResult> AddSettings([FromForm]SiteSettingsDto dto, IFormFile image)
{
    if (image != null)
    {
        using var memoryStream = new MemoryStream();
        await image.CopyToAsync(memoryStream);
        dto.FileContent = memoryStream.ToArray();
        dto.FileName = image.FileName;
    }
    
    await _siteSettingsService.SaveSettings(dto);
    return Ok();
}

这个方案最直接，但不适合大文件，因为byte[]会占用较多内存，容易引发性能问题。

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