Python端口校验为什么会放过true?把布尔值和整数分开检查

举报
某酱 发表于 2026/11/18 10:14:05 2026/11/18
【摘要】 用Python离线样例验证bool是int子类带来的端口校验歧义,以精确类型和1到65535范围检查拒绝布尔值、字符串、浮点数及越界值,区分目的端口和监听端口的输入契约。

给配置入口写校验时,isinstance(value, int) 看起来足够判断一个端口是不是整数。我用几个纯内存样例跑了一遍,发现True也会满足这个条件。

这对只允许JSON整数的目的端口字段会产生歧义:JSON里的true解析成Python的True,而True既是布尔值,也是int的实例。若后续又把它转换成int,结果就变成了1。

先说明这个函数接受什么

本例字段表示“连接目标服务的端口”,约定只接受Python内置int,范围1到65535;不接受布尔值、数字字符串、浮点数和空值。代码不建立网络连接,不扫描端口,不更改任何服务。

数字字符串是否可以自动转换,是接口设计选择。本例采取严格方式,让表单层或迁移层明确处理转换,避免同一个入口混用多种类型。

类型检查和范围检查分别做

下面的函数先检查 type(value) is int,再检查数值区间。这里使用精确类型判断,是为了实现上面已经写明的严格输入契约,而不是说所有Python函数都应该拒绝子类。

保存为validate_port.py后,可以直接运行:

def destination_port(value):
    if type(value) is not int:
        raise ValueError("port must be a JSON integer, not bool/string/float")
    if not 1 <= value <= 65535:
        raise ValueError("destination port must be in 1..65535")
    return value


if __name__ == "__main__":
    assert isinstance(True, int)
    print("isinstance(True, int): True")
    for value in [1, 443, 65535]:
        assert destination_port(value) == value
        print(f"accept {value}: PASS")
    for value in [True, False, 0, -1, 65536, "443", 443.0, None]:
        try:
            destination_port(value)
        except ValueError:
            print(f"reject {value!r} ({type(value).__name__}): PASS")
        else:
            raise AssertionError(repr(value))

测试覆盖了哪些边界

本机运行时,isinstance(True, int) 输出True。1、443、65535全部接受;True、False、0、-1、65536、字符串443、浮点443.0以及None共八个输入全部拒绝。

其中False也会被拒绝,但它的意义不只是“数值刚好等于0”。类型检查在前面就把布尔值排除,错误信息能准确表达字段要求。True则更能说明问题:它对应数值1,如果只检查isinstance和区间,就可能被允许。

再看443.0:它在数学意义上没有小数部分,却仍是浮点类型。若业务希望接受它,可以另写明确的转换流程;不要让校验函数在不同输入上悄悄改变规则。

目的端口与监听端口不要混为一谈

这里排除0,是因为本例定义的是目的端口字段。某些程序监听时使用0,让操作系统分配可用端口,是另一种接口语义。把这个函数直接放进允许自动分配端口的监听配置,会错误拒绝合法需求。

同样,保存范围正确的端口号,也不代表远端服务在线、可达或可信。端口字段校验、连通性测试和应用协议验证应当分别报告结果。

把输入契约写进测试

这个小例子最有价值的部分,是把“数字就行”拆成了可检查的约定:接受什么类型,如何处理边界值,要不要自动转换。以后修改配置格式时,先改契约和测试,再改实现,能更容易看出兼容性变化。

参考:Python内置函数文档bool与isinstance说明:https://docs.python.org/3/library/functions.html#bool。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。