OpenAPI PHP 客户端使用 anyOf 给出致命错误

Question

我正在尝试使用 anyOf 和 allOf 属性创建一个 OpenAPI 自动生成的 PHP 客户端。

目标是能够 return 具有多态性的数组：不同类型的对象。
这些对象也有一个共同的基础对象。

在我的示例模式中，Items 是一个数组，其中的项目可以是 ItemOne 或 ItemTwo 类型。
两种类型的项目都有自己的属性（分别为 itemOneProperty 和 itemTwoProperty）和共同的属性 baseItemProperty（继承自 BaseItem 使用 allOf 关键字）。

这里有 API 规范 yaml:

openapi: 3.0.0
info:
  title: Test API
  version: 1.0.0
servers:
  - url: https://api.myjson.com/bins

paths:
  /roxgd:
    get:
      operationId: getItems
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Items'
components:
  schemas:

    Items:
      type: array
      items:
        anyOf:
          - $ref: '#/components/schemas/ItemOne'
          - $ref: '#/components/schemas/ItemTwo'

    BaseItem:
      type: object
      properties:
        baseItemProperty:
          type: string

    ItemOne:
      allOf:
        - $ref: '#/components/schemas/BaseItem'
        - type: object
          properties:
            itemOneProperty:
              type: string

    ItemTwo:
      allOf:
        - $ref: '#/components/schemas/BaseItem'
        - type: object
          properties:
            itemTwoProperty:
              type: string

这是我发送请求的端点：https://api.myjson.com/bins/roxgd

它 return 这个例子 json:

[
    {
        type: "ItemOne",
        baseItemProperty: "foo1",
        itemOneProperty: "bar1"
    },
    {
        type: "ItemTwo",
        baseItemProperty: "foo2",
        itemTwoProperty: "bar2"
    }
]

生成的 PHP 客户端没有错误，但是当它调用 getItems 方法时我得到这个致命错误：

PHP Fatal error:  Uncaught Error: Class 'AnyOfItemOneItemTwo' not found in /home/user/projects/openapi-test/lib/ObjectSerializer.php:309
Stack trace:
#0 /home/user/projects/openapi-test/lib/ObjectSerializer.php(261): MyRepo\OpenApiTest\ObjectSerializer::deserialize(Object(stdClass), 'AnyOfItemOneIte...', NULL)
#1 /home/user/projects/openapi-test/lib/Api/DefaultApi.php(182): MyRepo\OpenApiTest\ObjectSerializer::deserialize(Array, 'AnyOfItemOneIte...', Array)
#2 /home/user/projects/openapi-test/lib/Api/DefaultApi.php(128): MyRepo\OpenApiTest\Api\DefaultApi->getItemsWithHttpInfo()
#3 /home/user/projects/tests-for-openapi-test/test.php(10): MyRepo\OpenApiTest\Api\DefaultApi->getItems()
#4 {main}
  thrown in /home/user/projects/openapi-test/lib/ObjectSerializer.php on line 309

如果我使用 oneOf 属性，也会发生同样的情况，但我得到的错误是：Uncaught Error: Class 'OneOfItemOneItemTwo' not found....

当我使用任何其他有效的 yaml（没有多态性）时，我的设置工作正常。

此外，我已经检查了，但那是关于 UI，我根本没有使用它。

你知道错误在哪里吗？我的 yaml 文档中有错误吗？ PHP 客户端生成器中的错误？

编辑：我使用的是 openapi-generator v4.0.3（此时的最新版本）。

Answer 1

经过更多研究，我发现从 4.0.0 版开始，openapi-generator 中的继承存在一个未解决的问题。

https://github.com/OpenAPITools/openapi-generator/issues/2845

OpenAPI PHP 客户端使用 anyOf 给出致命错误

OpenAPI PHP client giving Fatal Error with anyOf

php

polymorphism

swagger

openapi

openapi-generator