You need to enable JavaScript to run this app. Ubuntu环境Python3.8.5下TensorFlow2.4.1循环导入keras报错咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 06:36:04