.NET Core极简API上传图片至外部API报415错误，求排查方案

415错误是不支持的媒体类型，你的核心实现思路（上传图片到imgbb后将元数据存入MongoDB）是可行的，但当前实现存在参数绑定或请求配置的疏漏，导致服务器无法解析请求，以下是具体修正点：

1. 修正Minimal API的参数绑定逻辑 #

Minimal API无法自动将multipart/form-data中的文件映射到复杂对象的IFormFile属性，必须调整端点参数定义：

错误写法（无法绑定） #

app.MapPost("/api/items", async (Item item, ItemsService service) => {
    // 无法解析item.Image
});

正确写法1（单独接收文件参数） #

将IFormFile作为独立参数传入，再手动赋值给Item：

app.MapPost("/api/items", async (IFormFile image, ItemsService service) => {
    var item = new Item { /* 其他属性赋值 */ };
    // 调用imgbb上传逻辑，将返回的URL存入item
    await service.AddItem(item);
    return Results.Ok();
});

正确写法2（接收带表单字段的复杂对象） #

如果需要同时接收其他表单字段，用[FromForm]标记请求模型：

// 定义请求模型
public class ItemCreateDto {
    public string Name { get; set; }
    public IFormFile Image { get; set; }
}

// 端点配置
app.MapPost("/api/items", async ([FromForm] ItemCreateDto dto, ItemsService service) => {
    var item = new Item { Name = dto.Name };
    // 处理imgbb上传并设置item的图片URL
    await service.AddItem(item);
    return Results.Ok();
});

2. 修正Postman请求配置 #

Postman的错误配置是415的常见诱因，需确保：

• 请求方法为POST
• Body选择form-data类型，不要手动设置Content-Type请求头（Postman会自动生成正确的multipart/form-data; boundary=...）
• 表单键名必须与API参数名完全匹配：
  • 若用单独参数，键名填image；若用复杂对象，键名填Image（对应Dto的属性名）
  • 键的类型选择File，然后选择本地图片文件；其他字段类型选Text并填入对应值

3. 修正ItemsService与MongoDB实体类 #

注意：IFormFile不能直接存入MongoDB，它是请求上下文的临时流，需调整Item类并修改上传逻辑：

调整Item实体类 #

public class Item {
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public string ImageUrl { get; set; } // 存储imgbb返回的图片URL
    // 若要存本地字节，改用public byte[] ImageData { get; set; }
}

修正imgbb上传逻辑 #

将IFormFile转换为流上传到imgbb，再把返回的URL存入MongoDB：

public async Task AddItem(Item item, IFormFile image) {
    using var httpClient = new HttpClient();
    var formContent = new MultipartFormDataContent();
    formContent.Add(new StreamContent(image.OpenReadStream()), "image", image.FileName);
    formContent.Add(new StringContent("你的imgbb API密钥"), "key");

    var response = await httpClient.PostAsync("https://api.imgbb.com/1/upload", formContent);
    var imgbbResult = await response.Content.ReadFromJsonAsync<ImgbbResponse>(); // 需定义对应模型

    item.ImageUrl = imgbbResult.Data.Url;
    await _mongoCollection.InsertOneAsync(item);
}

总结 #

你的整体方案逻辑没问题，415错误主要是参数绑定和请求配置不匹配导致的，按上述步骤修正后即可解决问题。

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