FileActionResult返回损坏PDF文件问题排查求助

• 核心问题出在前端响应解析环节：浏览器默认会把未指定类型的响应当成UTF-8文本处理，原始二进制PDF字节被错误转换为多字节字符，导致最终生成的Blob文件大小翻倍、内容损坏（页数显示正确是因为PDF的元数据还残留，但实际内容字节已乱码）。
• API端生成的文件本身无问题，后端响应头配置也正确，排除后端文件生成和响应头的问题。

前端修复（必做） #

发起请求时必须明确指定响应类型为blob或arraybuffer，禁止浏览器自动解析为文本。以下是两种常见请求方式的修改示例：

若使用fetch请求 #

fetch('/你的下载接口路径', {
  method: 'GET',
  responseType: 'blob' // 关键：告诉浏览器直接接收二进制Blob
})
.then(response => {
  if (!response.ok) throw new Error('请求失败');
  return response.blob();
})
.then(blob => {
  // 复用你原有的下载逻辑，注意直接用原始blob即可
  let URL = window.URL || window.webkitURL;
  var downloadUrl = URL.createObjectURL(blob);
  var filename = '你的文件名.pdf'; // 可从响应头获取或提前定义
  
  if (filename) {
    var a = document.createElement("a");
    if (typeof a.download === 'undefined') {
      window.location.href = downloadUrl;
    } else {
      a.href = downloadUrl;
      a.download = filename;
      document.body.appendChild(a);
      a.click();
      document.body.removeChild(a); // 清理DOM
    }
  } else {
    window.location.href = downloadUrl;
  }
  URL.revokeObjectURL(downloadUrl); // 释放内存
});

若使用XMLHttpRequest请求 #

var xhr = new XMLHttpRequest();
xhr.open('GET', '/你的下载接口路径', true);
xhr.responseType = 'blob'; // 关键：指定响应类型
xhr.onload = function() {
  if (this.status === 200) {
    var blob = this.response;
    // 后续下载逻辑同上
    let URL = window.URL || window.webkitURL;
    var downloadUrl = URL.createObjectURL(blob);
    // ... 剩余代码
  }
};
xhr.send();

另外，你原有代码中binaryData.push(blob); let newBlob = new Blob(binaryData);属于多余操作，直接使用原始Blob即可，这步不会造成损坏，但完全没必要。

后端代码优化（可选，避免潜在问题） #

目前后端代码虽能正常返回文件，但可以优化得更简洁可靠：

public Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken)
{
    var response = new HttpResponseMessage();
    var filename = this.Document.GetFilename();
    var mimeType = MimeMapping.GetMimeMapping(filename);

    // 直接用ByteArrayContent代替StreamContent，避免流位置问题
    response.Content = new ByteArrayContent(this.Document.Data);
    
    response.Content.Headers.ContentType = new MediaTypeHeaderValue(mimeType);
    response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment")
    {
        FileName = filename,
    };

    return Task.FromResult(response);
}

• 使用ByteArrayContent无需手动设置ContentLength，框架会自动处理
• 避免了MemoryStream可能存在的位置偏移问题（比如未重置Position导致读取为空）

1. 前端修改后，下载文件对比API端文件大小，确认一致
2. 打开下载的PDF，检查内容是否正常显示

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