ASP.NET中如何返回带400/409错误状态码的FileContentResult？

你遇到的文件损坏问题，根源是直接修改Response.StatusCode后返回File()的方式会导致ASP.NET Core的响应处理流程冲突——FileContentResult默认会自动设置200状态码，手动提前修改响应状态码会打乱响应头（比如Content-Length）和文件内容的匹配，最终导致文件损坏。

正确的做法是直接给FileContentResult实例设置状态码，而不是修改全局的Response.StatusCode，同时注意使用正确的Excel文件MIME类型：

[HttpPost]
[Consumes("multipart/form-data")]
public async Task<ActionResult> Upload([FromForm] UploadSpreadsheetCommand command)
{
    var response = await _mediator.Send(command);

    if (response.IsValid)
        return Ok();

    // 创建FileContentResult实例，使用xlsx对应的标准MIME类型
    var errorFileResult = File(
        response.Data.SpreadsheetError,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "errors.xlsx");
    
    // 直接给文件结果设置错误状态码
    errorFileResult.StatusCode = StatusCodes.Status409Conflict;

    return errorFileResult;
}

关键说明： #

• 状态码设置方式：通过FileContentResult的StatusCode属性设置错误码，ASP.NET Core会自动协调响应头和状态码的关系，确保文件内容正确传输。
• MIME类型修正：对于.xlsx格式的Excel文件，应该使用application/vnd.openxmlformats-officedocument.spreadsheetml.sheet而非旧的application/ms-excel，避免客户端因MIME类型识别错误导致文件无法打开。

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