如何在Python数据类（Pydantic）中定义动态键名字段？

API返回的响应结构是以动态UUID为键的字典，键名不固定且不在请求参数中，Python标准数据类默认仅支持固定字段声明，无法直接将动态键定义为数据类属性，以下是几种可行的处理方案：

方案1：用数据类包裹动态映射 #

如果只需封装整个响应结构，无需单独提取UUID键和值，可以在数据类中定义一个映射类型字段，直接接收整个响应字典：

from dataclasses import dataclass
from typing import Mapping, str

@dataclass
class ApiResponse:
    dynamic_data: Mapping[str, str]  # 根据实际返回值类型替换str

使用示例：

response_dict = {"0e933a3c-0daa-4a33-92b5-89d38180a142": "someValue"}
api_response = ApiResponse(dynamic_data=response_dict)

# 访问动态键值对
for uuid_key, value in api_response.dynamic_data.items():
    print(f"UUID: {uuid_key}, Value: {value}")

方案2：自定义解析逻辑封装为固定字段 #

如果希望直接将UUID和对应值作为数据类的属性，可以通过类方法手动解析响应字典，提取动态键值对：

from dataclasses import dataclass
import uuid

@dataclass
class ApiResponse:
    uuid: str
    value: str

    @classmethod
    def from_response_dict(cls, response_dict):
        # 假设API返回仅包含一个键值对（可根据实际情况调整逻辑）
        if len(response_dict) != 1:
            raise ValueError("Response contains unexpected number of entries")
        
        uuid_str, value = next(iter(response_dict.items()))
        # 可选：验证键是否为合法UUID
        try:
            uuid.UUID(uuid_str)
        except ValueError:
            raise ValueError("Response key is not a valid UUID")
        
        return cls(uuid=uuid_str, value=value)

使用示例：

response_dict = {"0e933a3c-0daa-4a33-92b5-89d38180a142": "someValue"}
api_response = ApiResponse.from_response_dict(response_dict)

# 直接访问属性
print(api_response.uuid)  # 输出: 0e933a3c-0daa-4a33-92b5-89d38180a142
print(api_response.value) # 输出: someValue

方案3：使用TypedDict（仅类型提示场景） #

如果不需要数据类的实例特性，仅需为响应字典提供类型提示，可以直接使用Mapping类型：

from typing import Mapping, str

# 类型提示：键为UUID字符串，值为对应类型
ApiResponseType = Mapping[str, str]

# 使用时直接标注类型
def handle_response(response: ApiResponseType) -> None:
    uuid_str, value = next(iter(response.items()))
    # 处理逻辑

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