使用OpenAPI Generator生成Python客户端时出现AnyOf未定义错误

问题原因 #

当FastAPI接口使用response_model=Union[List[str], List[int]]时，会生成OpenAPI 3.1规范中的anyOf结构。OpenAPI Generator v7.1.0默认会为这种结构生成自定义的AnyOf类，但生成的代码中经常遗漏该类的导入语句，导致运行或测试时抛出NameError: name 'AnyOf' is not defined错误。

解决方案 #

方案一：生成客户端时指定用原生Union替代自定义AnyOf #

在生成Python客户端的Docker命令中添加--additional-properties pythonAnyOfImpl=union参数，让生成器直接使用Python原生的Union类型，避免生成自定义AnyOf类。

修改后的生成命令示例：

docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli:v7.1.0 generate -i /local/openapi.json -g python -o /local/client --additional-properties pythonAnyOfImpl=union

方案二：手动补全AnyOf类的导入（适用于已生成的代码） #

如果已经生成了客户端代码，可在所有出现AnyOf的文件顶部添加导入语句。假设AnyOf类位于openapi_client.models.any_of模块，添加如下代码：

from openapi_client.models.any_of import AnyOf

注意：需要先确认生成的代码中确实存在AnyOf类文件（通常在client/openapi_client/models/any_of.py路径下），如果不存在，说明生成器漏生成了该类，建议改用方案一重新生成。

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