NumPy 版本不兼容：_ARRAY_API 与 dtype size changed

现象与适用范围

适用于安装或更新节点后，导入 NumPy 相关扩展时出现 ABI 报错。问题通常发生在编译扩展与 NumPy 的二进制接口之间，而不是工作流连线本身。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

_ARRAY_API not found
numpy.dtype size changed
A module that was compiled using NumPy 1.x

已核对的依据

NumPy 官方将这些报错归入 C-API/ABI 不兼容，建议从 traceback 找第一个 NumPy 之外的包，检查该扩展是否支持当前 NumPy。 P03 P08

需要区分的情况

1. NumPy 升级后，仍加载按旧接口编译的扩展。

2. 环境混装导致导入了旧位置的二进制文件。

3. 节点依赖之间要求冲突，一次局部升级改变了共享环境。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 确认实际使用的 ComfyUI Python；若 NumPy 能导入，记录其版本和文件路径，并从 traceback 末端向上找第一个 NumPy 之外的包；不能仅截图最后一行。

第 2 步。 查对应扩展的发布和安装说明，优先用支持当前 NumPy 的兼容 wheel，而不是反复重新安装 NumPy 本身。

第 3 步。 如果故障明确始于 NumPy 2 升级且扩展没有兼容版本，可在可恢复的独立环境测试 NumPy 1.x；同时核对其他包是否要求 NumPy 2。

第 4 步。 执行 pip check，再尝试导入报错扩展与运行最小节点，记录经过验证的组合。

可复制的检查命令

在实际 ComfyUI Python 环境运行：

python -c "import numpy; print(numpy.__version__); print(numpy.__file__)"
python -m pip check

如何判断处理有效

目标扩展实际导入成功，并通过其节点最小测试。只看到 numpy.version 输出正常不能说明所有二进制扩展都兼容。

注意事项与尚未确认的部分

numpy<2 是条件性兼容策略，不是所有 ComfyUI 报错的通用修复。不要向所有环境全局安装这一约束。pip check 仅核对已安装包声明的依赖，不能验证二进制 ABI；仍需实际导入并测试受影响的节点。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• P03 · NumPy troubleshooting import errors。核对：2026-09-21。
• P08 · pip check。核对：2026-09-21。

相关排查与操作

• DLL load failed：定位原生扩展，不要下载散装 DLL 覆盖系统
• pip ResolutionImpossible：两个节点的依赖冲突怎么处理