Swagger 2.0 API引用定义模型在UI中不显示问题求助

问题定位 #

你提供的YAML片段存在两处关键语法错误，这是模型无法被识别的核心原因：

• $ref路径未闭合单引号：原片段中$ref: '#/definitions/TransactionDetails缺少结尾的'，Swagger解析器无法正确识别引用路径。
• 缩进和格式错误：-in应为- in（短横线后需加空格），且name、description、required等字段需与schema保持同级缩进，否则会被解析为schema的子属性，而非body参数的属性。

修正后的YAML片段 #

parameters:
  - in: body
    schema:
      $ref: '#/definitions/TransactionDetails'
    name: Transaction Details
    description: Body Parameters
    required: true

额外检查项 #

1. 确认definitions节点下确实存在TransactionDetails模型，且模型定义无语法错误，示例如下：

definitions:
  TransactionDetails:
    type: object
    properties:
      amount:
        type: number
      transactionId:
        type: string
    required:
      - amount
      - transactionId

2. 检查API路径的HTTP方法（如post、put）是否正确包含上述parameters节点，确保参数属于正确的请求方法。

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