.NET 6 Web API：ContentType为空返回500而非400的问题排查

问题背景 #

API请求负载包含Attachments JSON数组，每个附件包含以下属性：

• Name：字符串类型，存储待附加文件的名称
• ContentType：System.Net.Mime.ContentType类型，存储文件的媒体类型信息
• FileData：字符串类型，存储文件内容的Base64编码字符串

当ContentType中的MediaType为空字符串时，请求无法到达控制器，API直接返回500内部服务器错误，错误信息为：

Message: This property cannot be set to an empty string. (Parameter 'value')

期望API能接收任意输入，在内部完成校验后返回提示明确的400错误请求。触发错误的请求体示例：

"Attachments": [
    {
      "Name": "Something.txt",
      "ContentType": {
        "Boundary": null,
        "CharSet": null,
        "MediaType": "", // 此空值导致错误，希望返回400而非500
        "Name": "SampleContentType",
        "Parameters": [
          {
            "Key": "name",
            "Value": "SampleContentType"
          }
        ]
      },
      "FileData": "some base64 encoded string here"
    }
  ]

已知可通过自定义ContentType模型先校验再映射解决，但想明确：为何请求到达控制器前就抛出500错误？

原因解析 #

• 自带类型的属性约束：System.Net.Mime.ContentType是.NET框架内置类型，它的MediaType属性在设置值时，内部有严格的非空校验逻辑——一旦尝试赋值空字符串，会直接抛出ArgumentException。
• 模型绑定的执行时机：在ASP.NET Core的请求处理管道中，模型绑定发生在控制器方法执行之前。当框架尝试将JSON请求体映射到ContentType对象时，会给MediaType属性赋值空字符串，触发了该类型内部的异常。
• 默认异常处理逻辑：模型绑定阶段抛出的未处理异常，会被框架默认的异常处理机制捕获，直接返回500错误。此时请求还未进入控制器，自然无法执行你自定义的校验逻辑返回400错误。

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