.NET 8 XUnit测试中IFormFile参数始终为null的问题

问题根源分析 #

你的两次尝试都存在关键错误，导致控制器无法正确绑定csvFile参数：

1. 表单字段名不匹配：控制器参数名为csvFile，但第一次请求里表单字段用的是"file"，模型绑定无法匹配
2. 请求格式错误：第二次直接传文件字节流，没有用MultipartFormDataContent包装，不符合[FromForm]参数的接收要求
3. ContentDisposition配置错误：第二次用了attachment类型，应该用form-data，且必须指定与参数名一致的name属性

正确的测试代码实现 #

const string filePath = "CeaseBulkAccount.csv";
using var httpClient = ApiClient.HttpClient;

// 1. 创建MultipartFormDataContent作为请求容器
var formContent = new MultipartFormDataContent();

// 2. 读取文件内容并创建字节内容
byte[] fileBytes = File.ReadAllBytes(filePath);
var fileByteArrayContent = new ByteArrayContent(fileBytes);

// 3. 设置文件的MIME类型（CSV文件用text/csv）
fileByteArrayContent.Headers.ContentType = MediaTypeHeaderValue.Parse("text/csv");

// 4. 配置ContentDisposition：必须设置name为控制器参数名"csvFile"，同时指定filename
fileByteArrayContent.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
{
    Name = "csvFile",
    FileName = Path.GetFileName(filePath)
};

// 5. 将文件内容添加到表单容器
formContent.Add(fileByteArrayContent);

// 6. 发送POST请求
var response = await httpClient.PostAsync("/api/accounts/cease/bulk", formContent, ct);

关键注意事项 #

• 参数名严格匹配：ContentDisposition.Name必须和控制器的IFormFile参数名csvFile完全一致，模型绑定才能生效
• 正确的请求格式：所有[FromForm]参数都必须放在MultipartFormDataContent中，不能直接传原始字节流
• MIME类型设置：根据文件类型设置正确的ContentType，CSV文件推荐用text/csv，避免不必要的解析问题

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