PyLance抛出Exception属性访问警告的原因及非忽略式解决方法

警告抛出原因 #

PyLance在「standard」类型检查模式下会执行严格的静态类型分析。标准Exception类本身并没有定义status_code属性，尽管你用hasattr(e, "status_code")做了运行时属性存在性判断，但静态类型检查器无法通过这个运行时逻辑推断出e的具体类型——它仍会认定e是Exception实例，因此抛出属性不可访问的警告。

消除警告的方法（无需显式忽略类型） #

可以通过定义类型协议（Protocol）+ 类型守卫函数的方式，让PyLance识别出具有status_code属性的异常类型，完成类型范围缩小：

步骤1：定义协议与类型守卫 #

from typing import Protocol, TypeGuard

class StatusCodeCarrier(Protocol):
    # 描述具有status_code属性的类型协议
    status_code: int | str

def is_status_code_carrier(e: Exception) -> TypeGuard[StatusCodeCarrier]:
    # 类型守卫函数，告诉类型检查器满足条件的e属于StatusCodeCarrier类型
    return hasattr(e, "status_code")

步骤2：修改原有代码 #

try:
    None
except Exception as e:
    status_code = "error"
    if is_status_code_carrier(e):
        # 此时PyLance会识别e为StatusCodeCarrier类型，不再触发警告
        status_code = str(e.status_code)

如果是简单场景，也可以直接用typing.cast做类型转换（但这种方式不如类型守卫严谨）：

from typing import cast

try:
    None
except Exception as e:
    status_code = "error"
    if hasattr(e, "status_code"):
        status_code = str(cast(StatusCodeCarrier, e).status_code)

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