第一个示例的语法无效。替换为：

responses:
        '200':
          content:
            text/csv: {}  # <-----

          # Also note the correct syntax for referencing response headers:
          headers:
            Http-Header-Name:  # e.g. X-RateLimit-Remaining
              $ref: '#/components/headers/myHeader'

components:
  headers:
    myHeader:
      description: Description of this response header
      schema:
        type: string

至于你的第二个例子，OpenAPI规范没有提供CSV响应的例子。所以schema可以是type: string，或者一个字符串数组，或者一个空的模式{}（这意味着“任何值”），或者其他东西。实际支持的语法可能依赖于工具。请随意在OpenAPI Specification repository中要求澄清。

这是openapi 3.0.2从后端返回text/csv内容（字符串）的另一个工作：
合同：

responses:
            '200':
                content:
                    text/csv:
                        schema:
                            type: string

后端：

return ResponseEntity.ok("h1,h2,h3,h4\n1,2,3,4\n5,6,7,8");

下面是另一个例子：
合同：

responses:
    '200':
      schema:
        type: object

后端：

return ResponseEntity.status(200).contentType(MediaType.parseMediaType("text/csv")).body("Col 1;Col2\naaa;bbb\nccc;ddd");

试试这个--它应该可以让你用csv而不是json来记录一个例子。

responses:
    '200':
      description: 'Some data in csv format'
      content:
        text/csv:
          schema:
            type: string
          example: |-
            name, country, column etc
            Alice, UK, blah
            Bob, France, whatever