ASP.NET Core部分PDF/DOCX上传时IFormFile为NULL的问题求助

问题场景 #

基于ASP.NET Core使用IFormFile实现文件上传时，出现以下异常：

• 部分PDF、DOCX文件上传后后端IFormFile为NULL，其余文件上传正常
• 前端JS调试可正常获取到文件对象，但POST请求后后端接收为NULL，浏览器报错net::ERR_FAILED
• 已排除文件大小限制问题

涉及代码 #

后端C#代码：

public async Task<IActionResult> UploadFile(IFormFile file)
{
    // 此处部分场景下file为NULL，但部分PDF和DOCX文件上传正常
}

前端JavaScript代码：

var fileInput = document.getElementById('fileUpload');
var file = fileInput.files[0];
var formData = new FormData();
formData.append("file", file);

var xhr = new XMLHttpRequest();
xhr.open('POST', 'URL', true);
try {
    xhr.onload = function () {
        debugger;
        alert(xhr.status);
        if (xhr.status === 200) {
            
        } else {
           
        }
    };
    xhr.send(formData);
} catch (error) {
    alert(error);
}

排查与解决方法 #

1. 确保请求内容类型自动处理 #

不要手动设置XHR的Content-Type，FormData会自动生成带正确边界的multipart/form-data类型，手动设置可能导致后端无法解析文件边界。

2. 调整服务器表单请求限制 #

net::ERR_FAILED常与请求超时或表单大小限制有关，在Program.cs中扩展表单配置：

builder.Services.Configure<FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 104857600; // 100MB，按需调整
    options.BufferBodyLengthLimit = 104857600;
    options.Timeout = TimeSpan.FromMinutes(5); // 延长请求超时时间
});

3. 添加XHR错误监听定位问题 #

在前端代码中补充错误和超时监听，明确请求中断原因：

xhr.onerror = function() {
    console.error('请求异常中断:', xhr.statusText);
};
xhr.ontimeout = function() {
    console.error('请求超时');
};
xhr.onabort = function() {
    console.error('请求被中止');
};

4. 明确后端参数绑定来源 #

在后端方法参数上添加[FromForm]特性，明确指定从表单绑定：

public async Task<IActionResult> UploadFile([FromForm] IFormFile file)
{
    // ...
}

5. 处理文件名特殊字符 #

部分文件的特殊文件名可能导致解析异常，前端重命名文件后再上传：

// 替换文件名中的特殊字符为下划线
var safeFileName = file.name.replace(/[^a-zA-Z0-9_\-\.]/g, '_');
formData.append("file", file, safeFileName);

6. 排查服务器安全拦截 #

检查服务器是否有杀毒软件、WAF或安全中间件拦截了特定文件类型，临时关闭相关软件测试，或查看服务器安全日志确认是否有拦截记录。

内容的提问来源于stack exchange，提问作者Sanket R. Patil