为何ASP.NET Core API Action中字符串无法绑定到filename参数

这个问题其实和ASP.NET Core的模型绑定规则直接相关，我来给你拆解清楚：

1. 多简单类型参数的默认绑定行为 #

当你的接口方法用byte[] file和string filename这种多个简单类型参数时，ASP.NET Core的模型绑定默认不会从JSON请求体里读取参数值。它的优先级是：先从路由参数、查询字符串里找，再从表单数据（form-data）里找，完全不会主动解析JSON请求体来给这些参数赋值。

你用Fiddler发的是JSON格式的请求体，所以这两个参数都没法正确绑定：

• 没加[ApiController]时，框架没有自动做请求验证，filename会是null，后续写文件的逻辑大概率因为空路径抛出异常，导致500错误。
• 加上[ApiController]后，这个特性开启了自动请求验证，框架发现必填的filename参数没有绑定到值，就直接返回400错误（请求无效）。

2. 复杂类型参数的绑定逻辑 #

当你换成ProfileViewModel这种自定义复杂类作为参数时，情况就不一样了：
[ApiController]特性会自动给复杂类型参数加上[FromBody]标记，告诉框架从JSON请求体读取数据并反序列化成这个类。这样你的JSON里的filename和file字段就能精准映射到类的FileName和File属性上，绑定自然就正常了。

额外补充：如果不想用ViewModel怎么办？ #

因为[FromBody]特性只能用在一个参数上（请求体只能被读取一次），所以如果不想封装ViewModel，你可以把参数合并成一个匿名类或者用dynamic接收，然后手动提取值：

[HttpPost]
public void Post([FromBody] dynamic payload)
{
    string filename = payload.filename;
    byte[] file = payload.file;
    // 后续逻辑...
}

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