使用 AJAX 通过二进制流下载 .docx 文件时，若服务端未正确设置响应头或前端未按 Blob 类型处理响应，极易导致文件体积失真、结构损坏。本文提供一套经验证的 C# 后端 + JavaScript 前端协同方案，确保 .docx 文件完整、无损传输。
使用 ajax 通过二进制流下载 `.docx` 文件时，若服务端未正确设置响应头或前端未按 blob 类型处理响应，极易导致文件体积失真、结构损坏。本文提供一套经验证的 c# 后端 + javascript 前端协同方案，确保 `.docx` 文件完整、无损传输。
在 Web 应用中通过 HTTP 传输 .docx（本质为 ZIP 容器格式）等二进制 Office Open XML 文档时，任何字符编码干扰、响应体截断、类型误判或缓冲处理不当，都会破坏其内部 ZIP 结构，导致 Word 提示 “File is corrupt”。您遇到的 Byte Length: 4338（服务端） vs 7045 bytes（客户端 Blob）差异，正是典型症状——说明原始字节流在传输/解析过程中被错误地 UTF-8 编码或 JSON 化，导致二进制数据膨胀变形。
✅ 正确的服务端实现（C#）
关键在于绕过内存读取与字符串化中间环节，直接流式传输物理文件，并严格设置响应头：
context.Response.Clear();
context.Response.ContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
context.Response.AppendHeader("Content-Disposition", $"attachment; filename={documentFileName}");
// ⚠️ 不要手动设置 Content-Length — TransmitFile 会自动计算并写入
// ⚠️ 避免 BinaryWrite + ReadAllBytes：易受编码/缓冲影响，且占用内存
context.Response.TransmitFile(documentFilePath); // ✅ 零拷贝、高效、保真
context.Response.Flush();
context.Response.End();
为什么 TransmitFile 更可靠？
它由 IIS/ASP.NET 内核直接调用操作系统级文件传输机制（如 Windows 的 TransmitFile API），不经过 .NET 托管缓冲区，杜绝了 BinaryWrite 可能引发的字符集转换、换行符替换（如 \r\n → \n）或响应截断风险。
✅ 正确的前端实现（JavaScript）
必须确保 AJAX 请求原生接收二进制数据，并以 Blob 形式构造下载链接：
$.ajax({
type: "POST",
url: '/exportDataForDocument',
data: JSON.stringify(result),
contentType: "application/json",
xhrFields: {
responseType: 'blob' // ✅ 强制浏览器以 Blob 接收响应（非字符串！）
},
success: function(data, textStatus, xhr) {
// 从响应头安全提取文件名（避免 XSS，建议后端做 URL 编码）
const contentDisposition = xhr.getResponseHeader('Content-Disposition');
let fileName = 'document.docx';
if (contentDisposition && contentDisposition.indexOf('filename=') !== -1) {
fileName = contentDisposition.split('filename=')[1].replace(/["']/g, '').trim();
}
const blob = new Blob([data], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
});
const url = window.URL || window.webkitURL;
const objectUrl = url.createObjectURL(blob);
const a = document.createElement('a');
a.style.display = 'none';
a.href = objectUrl;
a.download = fileName;
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
url.revokeObjectURL(objectUrl); // ✅ 及时释放内存
},
error: function(xhr, status, error) {
console.error('Download failed:', status, error);
alert('文件下载失败，请重试。');
}
});
? 核心要点：
- ❌ 禁用 responseType: 'arraybuffer' + new Blob([data]) 的组合（jQuery 旧版本可能不兼容）；
- ✅ 必须使用 xhrFields: { responseType: 'blob' }，让 jQuery 底层 XMLHttpRequest 原生处理二进制；
- ✅ Content-Disposition 头中提取文件名需清洗引号与空格，防止脚本注入；
- ✅ revokeObjectURL 是良好实践，避免内存泄漏。
? 补充建议与验证方法
- 服务端日志验证：在 TransmitFile 前添加 Console.WriteLine($"File size: {new FileInfo(documentFilePath).Length}")，确认物理文件大小；
- 前端调试技巧：下载后立即用 FileReader 读取 Blob 并打印 blob.size，应与服务端日志完全一致；
- 替代方案（.NET Core/.NET 5+）：推荐使用 FileStreamResult 或 PhysicalFile()，语义更清晰、安全性更高；
- 安全注意：.docx 文件名必须经 Path.GetFileName() 过滤，禁止用户可控路径（防目录遍历）。
遵循以上方案，即可彻底解决 .docx 下载后损坏的问题，保障 Office 文档的完整性与可打开性。
