如何在运行时校验NamedTuple字段类型并抛出错误？

针对你遇到的原生NamedTuple无法在运行时校验字段类型的问题，这里有几种简洁的实现方式：

方案1：使用Pydantic（最省心的方案） #

Pydantic是专门做数据校验的工具库，它提供的NamedTuple会自动在实例化时完成类型校验，类型不匹配直接抛出明确的错误。

先安装依赖：

pip install pydantic

使用示例：

from pydantic import NamedTuple

class ParserParams(NamedTuple):
    api_url: str
    page_count: int
    timeout: float

# 传入字符串'3'会直接抛出ValidationError
parser_params = ParserParams(
    api_url='some_url',
    page_count='3',
    timeout=10.0,
)

运行时会立刻抛出ValidationError，提示page_count字段预期int类型，但实际传入了str。

方案2：自定义带校验的NamedTuple基类（无第三方依赖） #

如果不想引入额外库，可以通过重写__new__方法实现自动类型校验，把逻辑封装成基类后，所有子类都能复用：

from typing import NamedTuple, get_type_hints

class TypedNamedTuple(NamedTuple):
    def __new__(cls, **kwargs):
        # 获取当前类的所有类型注解
        field_types = get_type_hints(cls)
        for field_name, expected_type in field_types.items():
            field_value = kwargs.get(field_name)
            if not isinstance(field_value, expected_type):
                raise TypeError(f"字段'{field_name}'类型错误：预期{expected_type.__name__}，实际传入{type(field_value).__name__}")
        return super().__new__(cls, **kwargs)

# 继承自定义基类即可自动校验
class ParserParams(TypedNamedTuple):
    api_url: str
    page_count: int
    timeout: float

# 测试：传入字符串'3'会抛出TypeError
parser_params = ParserParams(
    api_url='some_url',
    page_count='3',
    timeout=10.0,
)

方案3：用装饰器给NamedTuple添加校验（灵活扩展） #

如果只想给特定的NamedTuple类添加校验，用装饰器的方式更灵活：

from typing import NamedTuple, get_type_hints

def validate_nt(cls):
    original_new = cls.__new__
    field_types = get_type_hints(cls)
    
    def checked_new(cls, **kwargs):
        for field_name, expected_type in field_types.items():
            field_value = kwargs.get(field_name)
            if not isinstance(field_value, expected_type):
                raise TypeError(f"字段'{field_name}'必须是{expected_type.__name__}类型，实际为{type(field_value).__name__}")
        return original_new(cls, **kwargs)
    
    cls.__new__ = checked_new
    return cls

# 给目标类添加装饰器即可
@validate_nt
class ParserParams(NamedTuple):
    api_url: str
    page_count: int
    timeout: float

# 测试：传入字符串'3'会抛出TypeError
parser_params = ParserParams(
    api_url='some_url',
    page_count='3',
    timeout=10.0,
)

可选扩展：自动类型转换 #

如果需要支持把合法的字符串自动转成目标类型（比如把'3'转成int），可以在校验逻辑里添加转换步骤，示例：

# 在校验循环中替换为：
try:
    field_value = expected_type(field_value)
    kwargs[field_name] = field_value
except (ValueError, TypeError):
    raise TypeError(f"字段'{field_name}'无法转换为{expected_type.__name__}类型")

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