NSwag生成代码时List<IFormFile>类型转换异常问题咨询

• DTO内的IFormFile（[FromBody]绑定）
  当List<IFormFile>放在标记了[FromBody]的DTO里时，NSwag默认认定请求体是JSON格式。但JSON没法直接序列化二进制文件，所以会把这个属性转成string[] | undefined——这里的字符串一般是文件的Base64编码或者路径，算是JSON场景下的替代方案，因为JSON本身不支持直接传文件。

• 直接作为方法参数的IFormFile
  当List<IFormFile>直接作为控制器方法的参数时，ASP.NET Core会自动识别这是用于文件上传的multipart/form-data请求。NSwag会匹配这个行为，生成专门处理文件上传的FileParameter类型，这个类型能承载文件的二进制数据、文件名等信息，和multipart请求格式完全适配。

• 核心逻辑：请求内容类型的推断
  NSwag会根据参数的绑定方式和位置自动推断请求的内容类型：

  • 带[FromBody]的DTO → 默认按application/json处理，不支持文件直接序列化，因此转字符串数组
  • 直接作为参数的IFormFile → 按multipart/form-data处理，需要文件专用类型，所以生成FileParameter

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