如何让OpenAPI Codegen生成支持XML请求响应的Python客户端？

1. 校验OpenAPI规范的XML配置 #

首先确认你的OpenAPI规范中，所有接口的请求/响应都明确声明application/xml作为Content-Type，并且为每个Schema添加XML结构注解，确保生成器能识别XML序列化规则。示例规范片段：

paths:
  /example/resource:
    post:
      requestBody:
        content:
          application/xml:
            schema:
              $ref: '#/components/schemas/ExampleRequest'
              xml:
                name: ExampleRequest
      responses:
        '200':
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ExampleResponse'
                xml:
                  name: ExampleResponse
components:
  schemas:
    ExampleRequest:
      type: object
      properties:
        item_id:
          type: integer
          xml:
            attribute: true # 标记为XML属性而非子元素
        item_name:
          type: string
      xml:
        name: ExampleRequest

2. 用OpenAPI Generator的XML专属参数生成 #

使用openapi-generator-cli时，必须显式启用XML支持并指定XML处理库，避免生成器默认忽略XML配置。示例生成命令：

openapi-generator-cli generate \
  -i your-api-spec.yaml \
  -g python \
  -o ./python-client \
  --enable-xml \
  --additional-properties=xmlLibrary=pydantic-xml,library=requests

• --enable-xml：强制生成器处理XML相关配置
• xmlLibrary=pydantic-xml：指定用pydantic-xml做序列化/反序列化（比默认库更可靠）
• library=requests：基于requests库生成，更容易手动调整XML逻辑

3. 手动修复生成代码的XML处理逻辑 #

如果生成的客户端仍无法处理XML，直接修改核心文件补充逻辑：

1. 安装依赖：pip install xmltodict pydantic-xml
2. 在生成的api_client.py中添加XML序列化/反序列化函数：

import xmltodict
from pydantic_xml import XmlModel

def serialize_xml_request(model: XmlModel) -> str:
    return model.to_xml(encoding='utf-8').decode('utf-8')

def deserialize_xml_response(xml_str: str, model_class: type[XmlModel]) -> XmlModel:
    return model_class.from_xml(xml_str)

3. 修改请求发送逻辑，当Content-Type为application/xml时，调用上述序列化函数处理请求体，响应时调用反序列化函数解析返回内容。

4. 切换到对XML更友好的生成器 #

如果上述方法都无效，尝试使用python-fastapi生成器，它对XML的支持更原生，生成的代码直接兼容pydantic-xml：

openapi-generator-cli generate \
  -i your-api-spec.yaml \
  -g python-fastapi \
  -o ./fastapi-based-client \
  --enable-xml

内容的提问来源于stack exchange，提问作者Дмитрий Воронецкий