Apple M1 Mac运行tensorflow-macos 2.11.0触发RuntimeError求助

环境与错误信息 #

开发环境 #

• 设备：Apple MacBook Air M1
• IDE：PyCharm
• 环境管理：Anaconda
• 依赖版本：
  • Python 3.9.15
  • tensorflow-macos 2.11.0
  • tensorflow-metal 0.7.0
  • numpy 1.21.5

导入代码片段 #

import os
import tensorflow as tf
import pandas as pd
from sklearn.preprocessing import MinMaxScaler

运行错误日志 #

/Users/kapo/opt/anaconda3/envs/env_tf/bin/python /Users/kapo/PycharmProjects/tensorflow-course/03/training_loop final.py 
RuntimeError: module compiled against API version 0x10 but this version of numpy is 0xf
RuntimeError: module compiled against API version 0x10 but this version of numpy is 0xf
ImportError: numpy.core._multiarray_umath failed to import
ImportError: numpy.core.umath failed to import
Traceback (most recent call last):
  File "/Users/kapo/PycharmProjects/tensorflow-course/03/training_loop final.py", line 2, in <module>
    import tensorflow as tf
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/__init__.py", line 37, in <module>
    from tensorflow.python.tools import module_util as _module_util
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/__init__.py", line 42, in <module>
    from tensorflow.python import data
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/__init__.py", line 21, in <module>
    from tensorflow.python.data import experimental
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/experimental/__init__.py", line 96, in <module>
    from tensorflow.python.data.experimental import service
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/experimental/service/__init__.py", line 419, in <module>
    from tensorflow.python.data.experimental.ops.data_service_ops import distribute
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/experimental/ops/data_service_ops.py", line 22, in <module>
    from tensorflow.python.data.experimental.ops import compression_ops
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/experimental/ops/compression_ops.py", line 16, in <module>
    from tensorflow.python.data.util import structure
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/util/structure.py", line 22, in <module>
    from tensorflow.python.data.util import nest
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/data/util/nest.py", line 34, in <module>
    from tensorflow.python.framework import sparse_tensor as _sparse_tensor
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/framework/sparse_tensor.py", line 24, in <module>
    from tensorflow.python.framework import constant_op
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/framework/constant_op.py", line 25, in <module>
    from tensorflow.python.eager import execute
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/eager/execute.py", line 21, in <module>
    from tensorflow.python.framework import dtypes
  File "/Users/kapo/opt/anaconda3/envs/env_tf/lib/python3.9/site-packages/tensorflow/python/framework/dtypes.py", line 34, in <module>
    _np_bfloat16 = _pywrap_bfloat16.TF_bfloat16_type()
TypeError: Unable to convert function return value to a Python type! The signature was
    () -> handle

Process finished with exit code 1

疑问 #

1. 如何修复此问题？
2. “module compiled against API version 0x10 but this version of numpy is 0xf”这句话是什么含义？

问题解答 #

错误含义解析 #

module compiled against API version 0x10 but this version of numpy is 0xf 翻译为：当前加载的编译模块依赖的Numpy API版本是0x10（对应Numpy 1.22及以上版本），但你环境中安装的Numpy版本是0xf（对应Numpy 1.21.x系列），两者API版本不匹配导致模块加载失败。

这里的0x10和0xf是十六进制数值，转十进制为16和15——Numpy从1.22版本开始将API版本升级到16，而1.21.x版本的API版本为15。你使用的tensorflow-macos 2.11.0编译时依赖更高版本的Numpy API，当前的Numpy 1.21.5版本无法满足要求，因此触发兼容性错误。

修复方案 #

方案1：升级Numpy到兼容版本

激活Anaconda环境后，执行命令升级Numpy到tensorflow-macos 2.11.0支持的版本（推荐1.22.x或1.23.x）：

conda activate env_tf
# 使用conda安装
conda install numpy=1.22.4
# 或使用pip安装
pip install numpy==1.22.4 --upgrade

方案2：重新安装匹配的TensorFlow依赖

如果升级Numpy后仍有异常，可彻底卸载现有相关包后重新安装，确保所有依赖版本匹配：

conda activate env_tf
pip uninstall tensorflow-macos tensorflow-metal numpy -y
pip install tensorflow-macos==2.11.0 tensorflow-metal==0.7.0 numpy==1.22.4

方案3：验证环境修复结果

在PyCharm中切换到env_tf环境，运行以下代码验证依赖是否正常加载：

import numpy as np
import tensorflow as tf
print(f"Numpy版本: {np.__version__}")
print(f"TensorFlow版本: {tf.__version__}")
print(f"Metal GPU检测结果: {tf.config.list_physical_devices('GPU')}")

若输出无报错且显示正确的版本信息，说明环境已修复完成。

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