Python实现将JSON数据转换为数据类的方法汇总

from dataclasses import dataclass, fields
import json
from datetime import datetime
from typing import Optional, Any

# 嵌套子数据类
@dataclass
class Address:
    province: str
    city: str
    detail: str = ""  # 可选字段

# 主数据类
@dataclass
class User:
    id: int
    name: str
    age: int
    register_time: datetime  # 非JSON原生类型（JSON中是字符串）
    address: Address  # 嵌套数据类
    tags: Optional[list[str]] = None  # 可选列表字段

# 测试JSON字符串（模拟接口返回/文件读取的JSON）
test_json_str = """
{
  "id": 1001,
  "name": "张三",
  "age": 28,
  "register_time": "2026-01-19T10:30:00",
  "address": {
    "province": "浙江省",
    "city": "杭州市",
    "detail": "西湖区XX路"
  },
  "tags": ["VIP", "新用户"]
}
"""

# 先将JSON字符串转成Python字典（所有方案的前置步骤）
test_json_dict = json.loads(test_json_str)

# 步骤1：处理嵌套数据类（Address）
address_dict = test_json_dict.pop("address")  # 提取嵌套字典
address = Address(**address_dict)  # 字典转嵌套数据类

# 步骤2：处理非基础类型（datetime字符串转datetime对象）
register_time_str = test_json_dict.pop("register_time")
register_time = datetime.fromisoformat(register_time_str)

# 步骤3：实例化主数据类（剩余字段直接传参）
user = User(
    **test_json_dict,  # 展开剩余基础字段（id/name/age/tags）
    address=address,
    register_time=register_time
)

# 验证结果
print(user)
# 输出：User(id=1001, name='张三', age=28, register_time=datetime.datetime(2026, 1, 19, 10, 30), address=Address(province='浙江省', city='杭州市', detail='西湖区XX路'), tags=['VIP', '新用户'])

def json_dict_to_dataclass(data: dict, cls) -> Any:
    """
    通用JSON字典转数据类函数（支持嵌套、datetime转换）
    :param data: JSON解析后的字典
    :param cls: 目标数据类（如User/Address）
    :return: 数据类实例
    """
    # 1. 遍历数据类的所有字段
    field_map = {f.name: f for f in fields(cls)}
    init_kwargs = {}
    
    for field_name, field_type in field_map.items():
        # 跳过不存在的字段（可选字段）
        if field_name not in data:
            continue
        
        value = data[field_name]
        target_type = field_type.type
        
        # 2. 处理嵌套数据类（判断是否是dataclass）
        if hasattr(target_type, "__dataclass_fields__"):
            init_kwargs[field_name] = json_dict_to_dataclass(value, target_type)
        # 3. 处理datetime类型（字符串转datetime）
        elif target_type is datetime:
            init_kwargs[field_name] = datetime.fromisoformat(value)
        # 4. 基础类型直接赋值
        else:
            init_kwargs[field_name] = value
    
    # 5. 实例化数据类
    return cls(**init_kwargs)

# 调用示例（一行搞定，支持嵌套）
user = json_dict_to_dataclass(test_json_dict, User)

# 验证结果
print(user)
print(user.address.city)  # 访问嵌套字段：杭州市
print(user.register_time.year)  # 访问datetime字段：2026

pip install pydantic

from pydantic import BaseModel
from datetime import datetime
from typing import Optional, List

# 替换原生dataclass为pydantic.BaseModel（语法几乎一致，功能更强）
class Address(BaseModel):
    province: str
    city: str
    detail: str = ""

class User(BaseModel):
    id: int
    name: str
    age: int
    register_time: datetime  # 自动将ISO格式字符串转datetime
    address: Address  # 自动转换嵌套模型
    tags: Optional[List[str]] = None

    # 可选：自定义类型转换规则（如非ISO格式的时间字符串）
    class Config:
        json_encoders = {
            datetime: lambda v: v.isoformat()  # 序列化时用，反序列化自动识别
        }

# 方法1：JSON字符串直接转模型（最优雅）
user = User.parse_raw(test_json_str)

# 方法2：JSON字典转模型（兼容已有字典）
# user = User(**test_json_dict)

# 验证结果
print(user)
# 输出：id=1001 name='张三' age=28 register_time=datetime.datetime(2026, 1, 19, 10, 30) address=Address(province='浙江省', city='杭州市', detail='西湖区XX路') tags=['VIP', '新用户']

# 便捷操作：模型转字典/JSON（反向操作也支持）
print(user.dict())  # 转字典
print(user.json(ensure_ascii=False, indent=2))  # 转格式化JSON字符串

ValidationError: 1 validation error for User
age
  Input should be a valid integer, got a string [type=int_type, input_value='28', input_type=str]