如何在OpenAPI 3.0.0中建模同时支持GET和POST的Flask端点？

当然可以实现，不用完全重复定义两个端点。OpenAPI 3.0的组件复用机制能帮你遵守DRY原则，核心思路是把重复的参数结构抽成可复用的组件，再在GET和POST方法里分别引用。

你的场景里，GET用查询参数（query），POST用表单参数（formData），两者的参数字段完全一致，只是传递位置不同。可以按以下步骤建模：

1. 定义共享的参数Schema #

先在components.schemas里统一定义参数结构，后续两种方法都能引用这个Schema：

components:
  schemas:
    SearchParams:
      type: object
      properties:
        brand:
          type: string
          description: 设备品牌
        model:
          type: string
          description: 设备型号
        capabilities:
          type: string
          description: 设备能力
      required: [] # 根据实际业务需求设置必填字段

2. 复用组件构建端点 #

OpenAPI不支持get, post:这种合并写法，必须分开定义HTTP方法，但通过组件复用能避免重复编写参数逻辑：

paths:
  /search:
    get:
      summary: 通过URL查询参数搜索设备
      parameters:
        - name: brand
          in: query
          schema:
            $ref: '#/components/schemas/SearchParams/properties/brand'
          description: 设备品牌
        - name: model
          in: query
          schema:
            $ref: '#/components/schemas/SearchParams/properties/model'
          description: 设备型号
        - name: capabilities
          in: query
          schema:
            $ref: '#/components/schemas/SearchParams/properties/capabilities'
          description: 设备能力
      responses:
        '200':
          description: 搜索结果列表
          # 可进一步复用响应Schema，比如：
          # content:
          #   application/json:
          #     schema:
          #       $ref: '#/components/schemas/SearchResults'
    post:
      summary: 通过表单参数搜索设备
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/SearchParams'
      responses:
        '200':
          description: 搜索结果列表
          $ref: '#/components/responses/SuccessSearchResponse' # 复用统一响应组件

额外优化：抽离参数组件 #

如果参数数量较多，还可以把单个参数也抽成组件，进一步简化端点定义：

components:
  # ... 上面的schemas部分
  parameters:
    SearchBrandQuery:
      name: brand
      in: query
      schema:
        $ref: '#/components/schemas/SearchParams/properties/brand'
      description: 设备品牌
    SearchModelQuery:
      name: model
      in: query
      schema:
        $ref: '#/components/schemas/SearchParams/properties/model'
      description: 设备型号
    # 同理可定义表单参数组件...

# 端点中直接引用组件
paths:
  /search:
    get:
      parameters:
        - $ref: '#/components/parameters/SearchBrandQuery'
        - $ref: '#/components/parameters/SearchModelQuery'
        # ...其他参数

内容的提问来源于stack exchange，提问作者Luca P.