Python端口校验为什么会放过true?把布尔值和整数分开检查
给配置入口写校验时,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。
- 点赞
- 收藏
- 关注作者
评论(0)