如何使用HttpPatch方法同时更新实体与上传关联文件？

我有一个包含若干图片的Style实体，希望通过HttpPatch方法对其执行更新操作。

现有新增接口实现 #

新增Style实体时我使用的方法如下：

[HttpPost]
public async Task<IActionResult> CreateStyleAsync([FromForm] StyleFiles styleFiles, [FromForm] StyleDTO style)

现存问题 #

现在尝试编写使用HttpPatch方法更新该Style的接口，已编写的代码如下，但Swagger中没有提供文件上传的入口：

[HttpPatch("{styleId}")]
public async Task<IActionResult> PatchStyleAsync([FromForm] StyleFiles styleFiles, Guid styleId, [FromBody] JsonPatchDocument styleDto)

Swagger中的显示效果可参考对应截图：Swagger中的Patch方法显示效果

相关类定义 #

StyleDTO定义 #

public class StyleDTO
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public string PreviewImage { get; set; }
}

StyleFiles类定义 #

public class StyleFiles
{
    public IFormFile Image { get; set; }
}

实现诉求 #

曾考虑拆分为两个独立接口，分别用于更新文件和实体本身，但希望避免采用这种拆分方式。

出现该现象的核心是ASP.NET Core模型绑定的规则冲突：

• [FromBody]特性会强制框架读取整个HTTP请求流作为JSON绑定的来源，请求流被读取后即被消费无法重置
• [FromForm]标注的参数、以及IFormFile类型的文件参数，依赖multipart/form-data格式的表单解析器工作，需要完整读取原始请求流才能解析出表单字段和上传文件
  当两类绑定来源同时存在时，请求流会被[FromBody]的JsonPatchDocument参数抢先占用，导致文件绑定失效；同时Swagger会将接口识别为纯JSON格式接收的接口，自然不会渲染文件上传的交互入口。
  另外原代码中JsonPatchDocument未指定泛型参数，也会导致框架无法正确匹配绑定目标，进一步加剧Swagger的识别异常。

不需要拆分接口，只要调整参数绑定规则，将所有入参统一为表单来源即可，具体改动如下：

1. 给接口添加[Consumes("multipart/form-data")]标注，明确告知框架和Swagger该接口接收多部分表单格式的请求，而非纯JSON
2. 将JsonPatchDocument参数上的[FromBody]替换为[FromForm]，同时补全JsonPatchDocument<StyleDTO>的泛型参数，让框架可以正确完成模型绑定

调整后的完整接口代码：

[HttpPatch("{styleId}")]
[Consumes("multipart/form-data")]
public async Task<IActionResult> PatchStyleAsync(
    [FromForm] StyleFiles styleFiles, 
    Guid styleId, 
    [FromForm] JsonPatchDocument<StyleDTO> styleDto)
{
    // 原有业务逻辑：通过styleDto生成更新后的实体模型、处理styleFiles中的上传文件即可
}

调用方式说明 #

前端调用时构造multipart/form-data格式的请求，添加两个表单字段即可：

• Image：对应StyleFiles中的文件字段，直接传入待上传的图片文件
• styleDto：对应JsonPatchDocument参数，传入Patch操作序列化后的JSON字符串，例如：

  [
    {"op":"replace","path":"/Name","value":"测试样式"},
    {"op":"replace","path":"/Description","value":"更新后的描述"}
  ]
  

调整完成后，Swagger会自动识别接口的表单属性，渲染出文件上传入口，同时可以正常解析Patch操作内容，单接口即可同时完成实体属性更新、图片上传的逻辑，不需要额外拆分接口。

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