如何解决Mac OS Big Sur环境下导入ecco_v4_py的NoneType错误
Mac OS Big Sur环境下导入ecco_v4_py触发inspect模块异常的解决方案
问题场景
升级至Mac OS Big Sur后因Spyder启动故障重建项目运行环境,环境需依赖用于处理ECCO状态估计数据的核心包ecco_v4_py。目前已在目标环境完成ecco_v4_py安装,但执行import ecco_v4_py as ecco时触发如下报错:
File "/Users/drew/anaconda3/envs/Salt/lib/python3.9/inspect.py", line 632, in cleandoc lines = doc.expandtabs().split('\n') AttributeError: 'NoneType' object has no attribute 'expandtabs'
已完成的排查操作
- 新建仅安装
ecco_v4_py与Spyder的干净环境,仍复现相同报错 - 新建环境安装降级版本的
ecco_v4_py,同样触发该错误 - 定位到触发报错的inspect模块内
cleandoc函数代码块,单独运行该段代码可正常执行,无异常。对应触发位置的源码如下:
def cleandoc(doc): """Clean up indentation from docstrings. Any whitespace that can be uniformly removed from the second line onwards is removed.""" try: lines = doc.expandtabs().split('\n') #This is the line that is failing except UnicodeError: return None else: # Find minimum indentation of any non-blank lines after first line. margin = sys.maxsize for line in lines[1:]: content = len(line.lstrip()) if content: indent = len(line) - content margin = min(margin, indent) # Remove indentation. if lines: lines[0] = lines[0].lstrip() if margin < sys.maxsize: for i in range(1, len(lines)): lines[i] = lines[i][margin:] # Remove any trailing or leading blank lines. while lines and not lines[-1]: lines.pop() while lines and not lines[0]: lines.pop(0) return '\n'.join(lines)
- 尝试安装更早版本的Python,未解决该问题
- 直接修改触发报错的
inspect.py文件,修复当前行报错后,后续会出现其他关联错误
现有临时方案的隐患
目前通过手动修改报错文件的方式临时让ecco_v4_py可正常运行,修改操作包括两项:
- 将代码中的
except UnicodeError修改为except (UnicodeError, AttributeError) - 对后续报错的变量使用
str()强制转换为字符串类型
该方式属于对Python标准库文件的直接篡改,会在环境重建、Python版本升级时被覆盖失效,同时可能破坏其他依赖inspect模块的包的正常逻辑,存在未知运行隐患,并非长期可行的修复方案。
标准修复路径
报错核心根因:
ecco_v4_py在模块初始化阶段会动态生成部分类/函数对象,部分对象的docstring属性被设置为None;而Python 3.9及更早版本的inspect.cleandoc函数未对入参为None的场景做前置校验,直接调用字符串方法触发异常。
可落地的无侵入修复方案有两种:
- 启动阶段做无侵入逻辑补丁:在项目代码的最开头(也就是执行
import ecco_v4_py之前),为inspect.cleandoc补充入参校验逻辑,补丁代码如下:
import inspect original_cleandoc = inspect.cleandoc def patched_cleandoc(doc): if doc is None: return None return original_cleandoc(doc) inspect.cleandoc = patched_cleandoc
该方案不会修改Python环境的标准库文件,补丁仅作用于当前运行的Python进程,不会影响其他项目的运行逻辑,在环境重建时只需保留这段启动代码即可,无额外维护成本。
- 升级Python版本至3.10及以上:官方在3.10版本的
inspect模块中已补充了doc为None时的前置判断逻辑,可从根源上匹配ecco_v4_py的动态类定义行为,不会触发该类属性错误。
内容的提问来源于stack exchange,提问作者Andrew
相关产品推荐
相关产品推荐

