OpenAPI能否在requestBody和response中引用组件Schema的属性？

不行，OpenAPI的$ref语法不能直接引用components/schemas中对象的单个属性，你示例里的#/components/schemas/User/fullName这种写法不符合规范，所以会报错。

为什么不行？ #

OpenAPI的$ref依赖JSON Pointer语法，它只能指向完整的Schema节点（即components/schemas下的顶级对象），不能直接定位到对象内部的properties子字段。单个属性的定义虽然是合法的Schema片段，但必须作为独立的顶级组件存在才能被引用。

解决方案： #

1. 把单个属性抽成独立的Schema组件（推荐）

直接将需要复用的属性定义在components/schemas下作为独立节点，然后在原User对象和需要引用的地方分别引用这些组件：

openapi: '3.0.2'
paths:
  /login:
    post:
      summary: login a user
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserFullName'  # 直接引用独立属性组件
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserId'  # 直接引用独立属性组件

components:
  schemas:
    UserId:  # 独立的id属性Schema
      type: string
      format: uuid
    UserFullName:  # 独立的fullName属性Schema
      type: string
    User:
      type: object
      properties:
        id: 
          $ref: '#/components/schemas/UserId'  # 在User对象里复用
        fullName:
          $ref: '#/components/schemas/UserFullName'  # 在User对象里复用

2. 用allOf间接复用属性（不推荐，适合临时场景）

如果不想抽独立组件，可以通过allOf结合properties和additionalProperties来实现仅包含目标属性的效果，本质是复用User对象里的属性定义：

openapi: '3.0.2'
paths:
  /login:
    post:
      summary: login a user
      requestBody:
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/User'
              properties:
                fullName: {}  # 空对象表示复用User中的fullName定义
              required: [fullName]
              additionalProperties: false  # 限制只能包含fullName属性
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/User'
                properties:
                  id: {}  # 复用User中的id定义
                required: [id]
                additionalProperties: false

components:
  schemas:
    User:
      type: object
      properties:
        id: 
          type: string
          format: uuid
        fullName:
          type: string

这种方式虽然不用抽组件，但写法繁琐，可读性不如第一种，优先推荐抽独立组件的方案。

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