解决ASP.NET Core非控制器中Excel导出的CS1955错误

错误原因 #

File是ControllerBase类提供的方法，仅能在继承了Controller或ControllerBase的控制器类中直接调用。你的仓储类不属于控制器范畴，直接调用File()会触发CS1955错误，因为仓储类中不存在可调用的File方法。

推荐解决方案：职责分离（仓储生成字节数组，控制器返回文件） #

遵循单一职责原则，让仓储类专注于生成Excel字节数组，将返回文件的逻辑交给控制器处理，这是最合理的实现方式。

1. 仓储类代码（仅生成字节数组） #

public class CustomerRepository
{
    public byte[] ConvertAllCustomerExcel()
    {
        // 使用EPPlus生成Excel的逻辑
        using var package = new ExcelPackage();
        var worksheet = package.Workbook.Worksheets.Add("客户列表");
        // 填充数据逻辑（例如：worksheet.Cells["A1"].Value = "客户ID";）
        
        return package.GetAsByteArray();
    }
}

2. 控制器代码（调用仓储并返回文件） #

在控制器中注入仓储类，调用生成字节数组的方法，再通过控制器的File方法返回Excel文件：

public class CustomerController : Controller
{
    private readonly CustomerRepository _customerRepo;

    public CustomerController(CustomerRepository customerRepo)
    {
        _customerRepo = customerRepo;
    }

    public IActionResult ExportExcel()
    {
        byte[] excelBytes = _customerRepo.ConvertAllCustomerExcel();
        // 设置ContentType和下载文件名
        return File(excelBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "客户列表.xlsx");
    }
}

备选方案：通过IHttpContextAccessor在仓储类中直接输出响应（不推荐） #

如果因特殊需求必须在仓储类中处理文件返回逻辑，可以通过注入IHttpContextAccessor操作响应流，但这种方式会增加仓储类与Http上下文的耦合，不利于单元测试和代码维护。

1. 注册IHttpContextAccessor（Program.cs） #

builder.Services.AddHttpContextAccessor();

2. 仓储类代码（直接写入响应） #

public class CustomerRepository
{
    private readonly IHttpContextAccessor _httpContextAccessor;

    public CustomerRepository(IHttpContextAccessor httpContextAccessor)
    {
        _httpContextAccessor = httpContextAccessor;
    }

    public async Task ConvertAllCustomerExcelAndExport()
    {
        // 生成Excel字节数组
        using var package = new ExcelPackage();
        var worksheet = package.Workbook.Worksheets.Add("客户列表");
        // 填充数据逻辑...
        byte[] excelBytes = package.GetAsByteArray();

        // 获取Http响应对象并设置响应头
        var response = _httpContextAccessor.HttpContext.Response;
        response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        response.Headers.Add("Content-Disposition", "attachment; filename=客户列表.xlsx");
        // 写入字节数组到响应流
        await response.Body.WriteAsync(excelBytes);
        await response.Body.FlushAsync();
    }
}

3. 控制器代码调用 #

public async Task<IActionResult> ExportExcel()
{
    await _customerRepo.ConvertAllCustomerExcelAndExport();
    return new EmptyResult();
}

总结 #

优先选择职责分离的方案，保持仓储类的纯粹性，让控制器处理Http响应相关逻辑，这样代码更易维护和测试。

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