.NET接口测试：Postman如何映射含IFormFile的Attachment集合

一、Postman中正确构造form-data请求 #

要让.NET正确绑定TestRequest对象，form-data的键名必须严格匹配对象的层级结构：

• 对于第一个附件：
  • 键：Attachments[0].FileId，值：输入合法的Guid字符串（例如3fa85f64-5717-4562-b3fc-2c963f66afa6）
  • 键：Attachments[0].File，类型选择File，并选择本地文件
• 对于第二个及更多附件，将索引递增即可：
  • 键：Attachments[1].FileId，值：另一个Guid字符串
  • 键：Attachments[1].File，类型选择File并选择文件

注意：每个Attachment的FileId和File必须成对出现，不能只传其中一个，否则模型绑定会失败。

二、修正模型初始化问题 #

在TestRequest类中添加构造函数，初始化Attachments集合，避免因集合为null导致绑定校验失败：

public class TestRequest
{
    public TestRequest()
    {
        Attachments = new List<Attachment>();
    }
    public ICollection<Attachment> Attachments { get; set; }
}

三、修复Swagger显示异常问题 #

默认Swagger对嵌套在集合中的IFormFile显示不友好，需在Swagger配置中添加自定义Schema过滤器修正：

1. 创建Schema过滤器类：

public class FormFileSchemaFilter : ISchemaFilter
{
    public void Apply(OpenApiSchema schema, SchemaFilterContext context)
    {
        if (context.Type == typeof(IFormFile))
        {
            schema.Type = "string";
            schema.Format = "binary";
        }
        else if (context.Type.IsGenericType && context.Type.GetGenericTypeDefinition() == typeof(ICollection<>) && 
                 context.Type.GetGenericArguments()[0] == typeof(Attachment))
        {
            foreach (var property in schema.Properties)
            {
                if (property.Key.Contains("File"))
                {
                    property.Value.Type = "string";
                    property.Value.Format = "binary";
                }
            }
        }
    }
}

2. 在Program.cs（或Startup.cs）中注册过滤器：

builder.Services.AddSwaggerGen(c =>
{
    c.SchemaFilter<FormFileSchemaFilter>();
    // 其他Swagger配置...
});

四、额外注意事项 #

• 确保请求的Content-Type为multipart/form-data（Postman选择form-data时会自动设置）
• 若FileId允许为空，可将其改为Guid?类型，否则必须在请求中提供合法Guid值
• 测试时可在接口方法中添加日志，确认绑定结果：

public async Task<ActionResult> Create([FromForm] TestRequest request) 
{
    foreach (var att in request.Attachments)
    {
        Console.WriteLine($"FileId: {att.FileId}, FileName: {att.File.FileName}");
    }
    return Ok("Test");
}

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