Python2与Python3异常变量未定义差异及兼容方案咨询

问题现象 #

在Python 2.7.18中，以下代码可正常捕获异常并在except块外部访问异常变量：

>>> ex = None
>>> try:
...   raise Exception("test")
... except Exception as ex:
...   print(ex)
...
test
>>> ex
Exception('test',)
>>>
>>> ex2 = None
>>> try:
...   raise Exception("test")
... except Exception as ex2:
...   print(ex2)
... finally:
...   print(ex2)
...
test
test

但在Python 3.10.8中运行相同代码，会触发NameError：

>>> ex = None
>>> try:
...   raise Exception("test")
... except Exception as ex:
...   print(ex)
...
test
>>> ex
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'ex' is not defined. Did you mean: 'hex'?
>>>
>>> ex2 = None
>>> try:
...   raise Exception("test")
... except Exception as ex2:
...   print(ex2)
... finally:
...   print(ex2)
...
test
Traceback (most recent call last):
  File "<stdin>", line 6, in <module>
NameError: name 'ex2' is not defined

差异原因 #

这是Python2和Python3对except Exception as var语句中变量作用域的处理逻辑不同导致的：

• Python2：except块中as绑定的变量会泄露到外部作用域，块执行结束后变量依然保留对异常对象的引用。
• Python3：为避免异常对象引发内存泄漏（异常对象可能包含栈帧引用，进而持有局部变量），从Python 3.0开始，except块中as绑定的变量仅在块内部有效，块执行结束后会被立即删除。哪怕之前给同名变量赋过None，也会被这个机制覆盖，导致外部访问时触发NameError。

兼容Python2和Python3的解决方案 #

核心思路是提前在外部作用域定义变量，在except块内将捕获到的异常对象手动赋值给这个外部变量，而非直接依赖as绑定的变量。

基础场景示例 #

ex = None
try:
    raise Exception("test")
except Exception as e:
    print(e)
    ex = e  # 将异常对象赋值给外部定义的变量
print(ex)  # Py2和Py3均能正常输出 Exception('test',)

带finally的场景示例 #

ex2 = None
try:
    raise Exception("test")
except Exception as e:
    print(e)
    ex2 = e  # 手动赋值给外部变量
finally:
    print(ex2)  # Py2和Py3均能正常输出 Exception('test',)

这种方式通过显式赋值，让外部变量持有异常对象的引用，绕过了Python3中except块变量的作用域限制，同时兼容Python2的行为。

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