导入qiskit-aer时遇ImportError: DLL加载失败问题求助

问题描述 #

运行代码：

from qiskit_aer import Aer

返回错误：

Traceback (most recent call last):
  File "C:\Users\cr18222\PycharmProjects\pythonProject\testing.py", line 1, in <module>
    from qiskit_aer import Aer
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\__init__.py", line 69, in <module>
    from qiskit_aer.aerprovider import AerProvider
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\aerprovider.py", line 20, in <module>
    from .backends.aer_simulator import AerSimulator
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\backends\__init__.py", line 17, in <module>
    from .aer_simulator import AerSimulator
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\backends\aer_simulator.py", line 24, in <module>
    from .aerbackend import AerBackend, AerError
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\backends\aerbackend.py", line 33, in <module>
    from ..noise.noise_model import NoiseModel, QuantumErrorLocation
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\noise\__init__.py", line 241, in <module>
    from .noise_model import NoiseModel
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\noise\noise_model.py", line 38, in <module>
    from ..backends.backend_utils import BASIS_GATES
  File "C:\Users\cr18222\PycharmProjects\pythonProject\.venv\Lib\site-packages\qiskit_aer\backends\backend_utils.py", line 30, in <module>
    from .controller_wrappers import aer_initialize_libraries
ImportError: DLL load failed while importing controller_wrappers: The specified module could not be found.

运行环境：

• qiskit-aer版本：0.15.1
• Python版本：3.11
• 操作系统：Windows 11

Mac环境下使用相同包版本无此问题，该问题较为少见。

解决方法 #

1. 安装Microsoft Visual C++ Redistributable包 #

qiskit-aer底层依赖C++运行库，Windows系统可能缺失对应组件：

• 下载并安装最新版x64架构的Microsoft Visual C++ Redistributable
• 安装完成后重启Python环境，重新测试导入代码

2. 降级Python版本 #

Python 3.11与qiskit-aer 0.15.1可能存在兼容性问题：

• 创建新虚拟环境，指定Python 3.10版本
• 在新环境中重新安装qiskit-aer：

  pip install qiskit-aer==0.15.1
  

• 测试导入是否正常

3. 更新qiskit-aer到兼容版本 #

升级qiskit-aer至支持Python 3.11的版本：

pip install --upgrade qiskit-aer

更新后重新运行导入代码

4. 重建虚拟环境 #

虚拟环境可能在创建或安装包时损坏：

• 删除当前虚拟环境文件夹（.venv）
• 重新创建虚拟环境：

  python -m venv .venv
  

• 激活环境后重新安装依赖：

  pip install qiskit-aer==0.15.1
  

5. 手动修复缺失的DLL #

使用Dependency Walker工具检测controller_wrappers.pyd依赖的具体DLL文件，找到对应文件后复制到以下路径之一：

• 虚拟环境的Lib\site-packages\qiskit_aer\backends目录
• Windows系统的System32目录
• Python安装目录

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