常见问题: 动态链接库(DLL)初始化例程失败

[weinibuliu]

如 #361 ，在 Windows 系统下遇到“动态链接库(DLL)初始化例程失败”。

[weinibuliu]

请首先检查系统的 vc_redist 运行库 是否已经正确安装/更新。

有至少两种排查方法：

• 检查随 Release 附带的 MaaPiCli.exe 是否可以正常运行。
• 检查 C:\Windows\System32 目录下 vcrumtime140.dll 版本（应当不低于 v14.40）
  如果没有正确安装/更新 vc_redist ，请自行安装/更新。

如果问题仍然存在，请检查相关语言环境下的 vcruntime140.dll 与 msvcp140.dll 的版本是否低于 v14.40 。如是，请将其替换。

以 Python 为例，请检查 Python 安装目录。

如果问题仍然未得到解决，请前往 QQ群: 595990173 或 提交 Issue 以获得进一步帮助。

参考：

• [MAA-win-x86_64] 动态链接库(DLL)初始化例程失败 #361

[HydrogenDeuterium]

如果使用venv 虚拟环境，放到 .venv/Script/ 路径下才可以：

PS > ls .venv/scripts | findstr .dll
-a---l         2025/6/29     12:46              0 libcrypto-3.dll
-a---l         2025/6/29     12:46              0 libffi-8.dll
-a---l         2025/6/29     12:46              0 libssl-3.dll
-a----         2025/6/26     14:55         585896 msvcp140.dll
-a---l         2025/6/29     12:46              0 python3.dll
-a---l         2025/6/29     12:46              0 python313.dll
-a---l         2025/6/29     12:46              0 sqlite3.dll
-a---l         2025/6/29     12:46              0 tcl86t.dll
-a---l         2025/6/29     12:46              0 tk86t.dll
-a---l         2025/6/29     12:46              0 vcruntime140.dll
-a---l         2025/6/29     12:46              0 vcruntime140_1.dll
-a---l         2025/6/29     12:46              0 zlib1.dll

[HydrogenDeuterium]

这个路径原来缺 msvcp140 ，vcruntime140 倒是够新

[SwordofMorning]

是的，以miniconda为例，路径下的版本默认是14.27，替换为更高版本后解决了WinError 1114。

[2025-10-07 01:14:11.874][INF] Traceback (most recent call last):
[2025-10-07 01:14:11.874][INF]   File "C:\Users\96921\Downloads\Compressed\MaaGF1-GUI-v1.5.34-x86_64-\agent\my_action.py", line 124, in register_custom_actions
[2025-10-07 01:14:11.874][INF]     AgentServer.register_custom_action("postKeyUp", PostKeyUpAction())
[2025-10-07 01:14:11.874][INF]   File "C:\Users\96921\miniconda3\Lib\site-packages\maa\agent\agent_server.py", line 56, in register_custom_action
[2025-10-07 01:14:11.874][INF]     AgentServer._set_api_properties()
[2025-10-07 01:14:11.876][INF]   File "C:\Users\96921\miniconda3\Lib\site-packages\maa\agent\agent_server.py", line 106, in _set_api_properties
[2025-10-07 01:14:11.876][INF]     ^^^^^^^^^^^^^^^^^^^^^^
[2025-10-07 01:14:11.876][INF]     Library.agent_server().MaaAgentServerRegisterCustomRecognition.restype = MaaBool
[2025-10-07 01:14:11.876][INF]   File "C:\Users\96921\miniconda3\Lib\site-packages\maa\library.py", line 105, in agent_server
[2025-10-07 01:14:11.876][INF]     Library._agent_server = Library._lib_type(str(Library.agent_server_libpath))  # type: ignore
[2025-10-07 01:14:11.876][INF]                             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[2025-10-07 01:14:11.876][INF]     self._handle = _dlopen(self._name, mode)
[2025-10-07 01:14:11.876][INF]                    ^^^^^^^^^^^^^^^^^^^^^^^^^
[2025-10-07 01:14:11.889][INF]   File "C:\Users\96921\miniconda3\Lib\ctypes\__init__.py", line 376, in __init__
[2025-10-07 01:14:11.889][INF] OSError: [WinError 1114] 动态链接库(DLL)初始化例程失败。