首页 > 解决方案 > 如何在 Swagger UI 中的 multipart/form-data 请求中显示复杂对象?

问题描述

我正在使用 OpenAPI 3.0.1 并尝试将请求发送为multipart/form-data. 请求正文定义如下:

       requestBody:
         content:
           multipart/form-data: # Media type
             schema:            # Request payload
               type: object
               properties:      # Request parts
                 media:            # Part 1 (string value)
                   type: string
                 address:       # Part2 (object)
                   type: object
                   properties:
                     street:
                       type: string
                     city:
                       type: string
                 profileImage:  # Part 3 (an image)
                   type: string
                   format: binary

在这里,address字段是一个对象。Swagger UI 显示address字段本身,但不显示其属性streetcity. 这是为什么?

Swagger UI 中的多部分表单字段

标签: multipartform-dataswagger-uiopenapi

解决方案


此问题已在 Swagger UI v. 3.51.0 中修复。确保您使用的是最新版本。


推荐阅读