ASP.NET Core MVC IFormFile接口报415错误排查求助

数据老陈

2026-5-28

解决ASP.NET Core接口调用返回415 Unsupported Media Type的问题

我之前也碰到过一模一样的情况——Postman调用正常，但前端或Fiddler模拟请求就返回415，明明Content-Type都是multipart/form-data。结合你的场景，咱们一步步排查：

一、先排查最容易忽略的参数绑定问题

默认情况下，ASP.NET Core对IFormFile的绑定需要明确指定来源。虽然Postman可能自动适配，但Angular或Fiddler的请求可能因为框架默认行为导致绑定失败。给你的参数加上[FromForm]特性试试：

[HttpPost]
public IActionResult ChangePicture([FromForm] IFormFile file) 
{ 
    // 你的业务逻辑
    return Ok(); 
}

这个特性明确告诉框架从表单数据中解析IFormFile，很多时候415就是因为框架没找到正确的绑定来源导致的。

这是前端最容易踩坑的地方：

确保FormData的键名和接口参数名完全一致
比如你的接口参数是file，前端append的时候必须对应：
```
const formData = new FormData();
// 第三个参数可选，但最好带上文件名
formData.append('file', selectedFile, selectedFile.name);
```
如果键名不匹配，服务器找不到对应参数，也可能返回415。
不要手动设置Content-Type
很多人会犯这个错：手动给请求头加Content-Type: multipart/form-data，但这样会丢失自动生成的boundary（就是你看到的----blablabla部分）。正确的做法是让浏览器自动生成请求头：
```
// 错误写法：手动设置Content-Type
// this.http.post('/api/ChangePicture', formData, { headers: { 'Content-Type': 'multipart/form-data' } });

// 正确写法：不手动设置Content-Type
this.http.post('/api/ChangePicture', formData).subscribe(...);
```
手动设置的话，服务器无法识别请求的边界，自然会返回415。

如果上面的方法没用，就得深入调试了：

用Fiddler对比Postman和Angular的请求Raw内容
把两个请求的Raw（包括头部和body）复制出来逐行对比：
- 除了boundary字符串，Content-Type的格式是否完全一致？
- 请求的Accept头有没有差异？Postman默认是*/*，如果Angular设置了特定的Accept（比如application/json），而你的接口返回的是Ok()（默认text/plain），也可能触发415？
- body部分的Content-Disposition是否正确？比如Postman的body里会有name="file"; filename="xxx.jpg"，Angular的请求里有没有这个？
启用ASP.NET Core的详细调试日志
在Program.cs里添加日志配置，查看框架处理请求的过程：
```
builder.Logging.AddDebug().SetMinimumLevel(LogLevel.Debug);
```
启动项目后，在调试窗口查看日志，重点找和Multipart、ModelBinding、MediaType相关的错误信息，框架会告诉你为什么拒绝这个请求。

内容的提问来源于stack exchange，提问作者mohammad rostami siahgeli