AssertionError
错误信息
AssertionError
快速摘要
assert 语句检查条件那个 evaluated 到假, indicating programming bug.
为什么发生
invariant or precondition 是 violated
函数接收 unexpected 输入 (programming 错误, 不用户错误)
内部状态 assumption 是错误
最小示例
✗ 错误代码
def get_first(items):
assert len(items) > 0 # AssertionError if empty
return items[0]
get_first([]) # AssertionError✓ 修复代码
def get_first(items):
if not items:
raise ValueError("List cannot be empty")
return items[0]
# get_first([]) raises ValueError with a clear messageReplace assert 使用 explicit 如果/raise for validation 那个必须运行 in production. Assertions 能是 禁用使用 -O flag.
如何诊断
读取 assert 语句 and 它的消息
检查值 是 asserted
Determine 如果 assertion 是正确 or code 有 bug
如何修复
Fix code 那个 caused assertion 到失败
添加更多 descriptive 消息到 assert 语句
Replace assert 使用 explicit 如果/raise for production validation
如何预防
Use assertions for 内部 invariants, 不用户输入 validation
编写清晰 assertion 消息
Don't rely on assertions for production 错误 handling (它们能 是禁用)