OpenAPI 3.0.3中Swagger UI不显示文件上传及请求体选项问题

我按照Swagger官方文档尝试为POST请求添加文件上传选项，但Swagger UI既不渲染文本输入项，也不显示文件输入项。我已在Stack Overflow搜索相关解决方案但无结果，以下是为路径的requestBody参数定义的请求体YAML代码，请问我哪里配置错误？

CreateTicketMessagePayload:
      description: |-
        Request multipart body required to proceed in the ticket message creation processes.
        
        **Object part**:
        ```
        {
          "message": "Textual content of the message",
          "private": "Flag that indicates the message is visible just for technicians"
        }
        ```
        **File part**:
        "attachment": Message attachment file.
      content:
        multipart/form-data:
          schema:
            type: object
            properties:
              message:
                type: string
                example: This is a message
              private:
                type: boolean
                example: false
              attachment:
                type: string
                format: binary

问题分析与修复方案 #

你的配置缺少了encoding字段来指定非文件参数的内容类型，这是Swagger UI无法正确渲染输入控件的核心原因。对于multipart/form-data类型的请求，除了文件参数外，其他结构化参数需要明确指定contentType，Swagger UI才能识别并生成对应的输入框。

修正后的完整YAML配置如下：

CreateTicketMessagePayload:
  description: |-
    创建工单消息流程所需的多部分请求体。
    
    **对象部分**:
    ```
    {
      "message": "消息的文本内容",
      "private": "标识消息仅对技术人员可见的标志"
    }
    ```
    **文件部分**:
    "attachment": 消息附件文件。
  content:
    multipart/form-data:
      schema:
        type: object
        properties:
          message:
            type: string
            example: 这是一条消息
          private:
            type: boolean
            example: false
          attachment:
            type: string
            format: binary
      # 新增encoding配置，指定非文件参数的内容类型
      encoding:
        message:
          contentType: application/json
        private:
          contentType: application/json

添加encoding字段后，Swagger UI会正确识别message和private为JSON格式的参数，渲染出文本输入框和布尔选择器，同时attachment会显示为文件上传控件。

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