具有相同代码的多个响应的 PHP swagger 注释

Question

在我的 Controller 方法之一中，我尝试放置这样的注释:

 *     @OA\Response(
 *         response="404",
 *         description="Invalid field"
 *     ),
 *     @OA\Response(
 *         response="404",
 *         description="Entity not found"
 *     )

但是现在当我尝试构建文档时，我从 openapi 收到一条错误消息:

Warning: Multiple @OA\Response() with the same response="400":

我知道现在有一个 oneOf Swagger ，这似乎正是我的目的。但是，我不知道如何使用它。

Answer 1

     *@OA\Response(
     *          response=200,
     *          description="Successful operation",
     *          @OA\JsonContent(
     *              oneOf={
     *              @OA\Schema(ref="#/components/responses/schema1"),
     *              @OA\Schema(ref="#/components/responses/schema2"),
     *     }
     *          ),
     *),