Swagger 上传文件 不是formdata类型

Swagger 是一款流行的 API 设计工具，它可以帮助开发者文档化 RESTful 接口，并提供交互式界面给测试人员和客户端开发。当需要在 Swagger 中上传文件时，通常会遇到不是 `formData` 类型的问题，因为默认情况下，Swagger 使用 `formData` 格式来描述表单提交的数据，包括文件上传。

如果你的 API 需求是要上传二进制文件，而不是通过普通表单字段，可以尝试以下几个步骤：

1. **使用 `multipart/form-data`**: 更新你的 API 请求定义，指定 `Content-Type` 为 `multipart/form-data`，这是标准的文件上传内容类型。

   parameters:
     - name: file
       in: formData
       description: 要上传的文件
       required: true
       type: file
       format: binary

2. **添加文件上传支持**：在服务器端处理程序中，你需要解析这个 `multipart/form-data` 请求体，从中获取上传的文件部分。

3. **使用 `x-www-form-urlencoded` 或 `json` 表示文件 URL**：如果允许直接上传文件URL而不是文件本身，可以在 Swagger 的文档中使用 `url` 或 `string` 类型，并附上文件描述。

4. **自定义编码**：对于更复杂的情况，你可以创建一个自定义的编码器（encoder），将文件数据编码成非 `formData` 类型，但这种方式相对较少见。

记得，在文档中清楚地说明用户应该如何提供文件信息，因为这可能会根据实际的技术栈有所不同。