Ubuntu环境Python3.8.5下TensorFlow2.4.1循环导入keras报错咨询
TensorFlow 导入Keras触发循环初始化报错的解决思路
触发场景说明
运行环境为Ubuntu系统,Python 3.8.5、TensorFlow 2.4.1版本组合,执行对应代码时触发报错:
ImportError: cannot import name 'keras' from partially initialized module 'tensorflow' (most likely due to a circular import)
原始执行代码为:
import tensorflow as tf from tensorflow import keras import numpy as np import matplotlib.pyplot as plt fashion_mnist = keras.datasets.fashion_mnist
可通过以下方向排查修复:
- 排查文件名重名冲突
这是该报错最高发的触发原因:如果当前运行的脚本命名为tensorflow.py、keras.py,或者同目录下存在同名的tensorflow.py、keras.py文件,Python的导入优先级会优先加载当前目录下的自定义文件,而非site-packages下的官方安装包,最终形成循环导入。需要将冲突文件重命名为无歧义的自定义名称(比如fashion_mnist_demo.py),同时删除同目录下的__pycache__缓存文件夹、后缀为.pyc的残留编译文件,避免旧缓存被重新加载。 - 修复环境安装冲突
当前使用的Python 3.8.5 + TensorFlow 2.4.1版本组合本身兼容,但安装流程的残留冲突会导致TensorFlow模块未完成全量初始化就被外部调用。按以下步骤重装即可修复:- 完全卸载相关残留包:执行
pip uninstall tensorflow tensorflow-estimator keras -y - 清理pip缓存后重新安装指定版本的TensorFlow:
pip install tensorflow==2.4.1,注意不要单独安装独立的PyPI源keras包,TensorFlow 2.4.1已经内置完全匹配的Keras实现,额外安装的独立keras版本会触发版本不兼容的导入冲突。
- 完全卸载相关残留包:执行
- 调整导入顺序规避加载时序问题
部分场景下第三方包的交叉导入时序问题,会打断TensorFlow的初始化流程,可以将非TensorFlow依赖的导入逻辑前置,调整后代码参考:import numpy as np import matplotlib.pyplot as plt import tensorflow as tf from tensorflow import keras fashion_mnist = keras.datasets.fashion_mnist - 排查其他覆盖标准库的重名文件
检查当前脚本所在文件夹下,是否存在numpy.py、matplotlib.pyplot.py这类与官方包路径、文件名完全一致的自定义文件,这类文件会被Python优先加载,打断TensorFlow的正常初始化流程,需要全部重命名移除冲突。
内容的提问来源于stack exchange,提问作者Damian Spizzirri
相关产品推荐
相关产品推荐

