Python函数参数校验写法咨询：手动校验入参的实现方式是否正确

这种手动写条件判断校验入参的方式是合法可用的实现方案，适合轻量、单函数的校验场景，但现有实现存在逻辑缺陷，也有可优化的空间，具体说明如下：

现有实现的问题 #

• 校验顺序不合理：应该先校验参数类型，再校验参数值。现有代码先判断name == ""、age == 0，再判断类型，虽然最终报错结果没问题，但如果传入非字符串类型的name、非int类型的age时，会先做无意义的值判断，极端场景下甚至会出现逻辑漏洞（比如Python中bool是int的子类，isinstance(True, int)返回True，现有代码会把age=True校验通过，实际值为1不符合业务预期）
• 空值判断不严谨：现有代码只判断name == ""，如果传入全空格的字符串（比如" "）会被判定为合法，不符合“不能为空”的业务要求

手动校验的优化版本 #

如果坚持用手动校验的方案，调整逻辑后的代码如下：

# 打印问候语，name为非空字符串，age为大于0的整数
def functionX(name: str, age: int) -> None:
    # 先校验类型
    if not isinstance(name, str):
        raise TypeError("name must be a string")
    if not isinstance(age, int) or isinstance(age, bool):
        raise TypeError("age must be an integer and cannot be boolean")
    # 再校验值合理性
    if len(name.strip()) == 0:
        raise ValueError("name cannot be empty or blank")
    if age <= 0:
        raise ValueError("age must be greater than 0")
    print(f"hello {name}, you seem to be {age} years old")

其他可选方案 #

如果项目中存在大量需要入参校验的函数，手动写判断会导致代码冗余、维护成本高，可以考虑用装饰器封装通用校验逻辑，或者引入pydantic等校验库配合类型提示实现更简洁的入参校验。

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