Swagger Editor（OpenAPI 3.0）调试文件上传接口无文件浏览器问题求助

嘿，我之前也碰到过一模一样的问题！核心原因是你的OpenAPI配置没正确适配文件上传的格式要求，导致Swagger Editor没法识别这是个文件上传接口，所以才只显示了JSON输入框。

你大概率遗漏了这两个关键配置：

• 请求体必须用multipart/form-data媒体类型：文件上传的标准格式是表单数据，而非JSON，Swagger只有识别到这个类型才会渲染出文件选择器。
• 参数格式要指定为binary：明确告诉Swagger这个字符串参数对应本地文件，不是普通文本内容。

给你一个正确的单图片上传接口YAML示例，你可以对比着修改自己的配置：

paths:
  /api/upload-image:
    post:
      summary: 单张图片上传接口
      requestBody:
        required: true  # 标记上传为必填操作
        content:
          multipart/form-data:  # 关键：使用表单数据格式
            schema:
              type: object
              properties:
                imageFile:  # 参数名称可自定义
                  type: string
                  format: binary  # 关键：指定为二进制文件格式
                  description: 要上传的图片文件（支持JPG/PNG等常见格式）
      responses:
        '200':
          description: 上传成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  fileId:
                    type: string

如果需要支持多张图片批量上传，只需要把参数改成数组类型即可：

properties:
  imageFiles:
    type: array
    items:
      type: string
      format: binary
    description: 批量上传的图片文件列表

修改完配置后刷新Swagger Editor，再点击「Try it out」，就能看到文件选择按钮啦！

内容的提问来源于stack exchange，提问作者Abu Romaïssae