Windows Server 2008 R2运行PyInstaller打包exe报LoadLibrary错误如何解决

故障基本信息 #

• 故障环境：Windows Server 2008 R2老旧服务器
• 报错场景：运行Python打包生成的可执行文件时触发DLL加载错误，原Python开发人员已离职，排查人员为.NET方向开发，不熟悉Python运行机制
• 本地测试结果：同一份可执行文件在本地机器运行无异常，问题仅出现在目标服务器上

报错详情 #

Error Loading Python DLL 'C:\users\user\AppData\Local\Temp\3\_mEI\python39.dll
No error message generated.
FormatMessageW: The parameter is incorrect.
LoadLibrary: Pyinstaller: FormatMessageW failed.

已执行排查操作 #

• 卸载并重新安装Python
• 尝试重新编译该Python可执行文件
• 通过命令提示符携带参数运行程序
• 在本地机器运行该可执行文件，未复现上述错误

后续可行排查与解决步骤 #

• 检查系统基础版本与依赖
  先确认目标服务器的Windows Server 2008 R2已经安装SP1服务包，未安装SP1的版本根本跑不了Python3.9。其次装对匹配程序位数的Microsoft Visual C++ 2015-2019 Redistributable运行库，PyInstaller打包的Python3.9程序默认依赖这个运行库，Win2008R2默认不带。最后打上系统补丁KB2533623，这个补丁修复了老系统临时目录DLL加载的兼容性问题，缺了就容易出这类加载错误。
• 排查临时目录权限与残留问题
  报错路径指向当前用户的系统临时目录，PyInstaller单文件模式跑的时候会自动把运行时文件解压到这里。先把占用临时目录的程序都关了，手动清空C:\users\user\AppData\Local\Temp\下所有残留文件，避免之前损坏的解压文件干扰加载。再确认运行程序的账号对这个Temp目录有读、写、执行的完整权限，别用权限受限的来宾账号跑程序。
• 调整打包参数适配老系统兼容性
  高版本PyInstaller已经不支持Win2008R2，重新打包的时候用PyInstaller 4.10版本配Python3.9环境就行。打包的时候别用单文件模式（去掉-F参数），改成目录模式打包，直接跳过临时目录解压的逻辑，从根源上避开Temp目录相关的加载问题。如果必须用单文件模式，打包的时候加--runtime-tmpdir C:\py_runtime参数，指定一个不在系统临时目录下、权限可控的固定路径当运行时解压目录，绕开系统Temp目录的安全策略限制。
• 排查系统安全策略与拦截
  查下服务器有没有开AppLocker应用控制、DEP数据执行保护策略，有没有装终端安全、杀毒类软件，这类防护默认会拦截Temp目录下加载未知DLL的操作。可以临时关了防护软件测试，或者把程序路径、指定的运行时解压路径加到白名单里。另外右键点程序开属性面板，看看有没有“解除锁定”的按钮——从其他机器拷到服务器的文件会被Windows默认标成风险文件阻止加载，手动解锁之后再运行测试。
• 验证DLL本身有效性与依赖完整性
  用7-Zip之类的压缩软件直接打开打包好的exe，把里面的python39.dll提出来放到exe同级目录，再跑程序测试：如果能正常启动，说明问题全出在临时目录解压加载环节，按前面的临时目录、打包参数方案处理就行。如果还是加载失败，用依赖项检查工具打开提出来的python39.dll，看缺了什么关联依赖文件，对应补全系统文件就可以。
• 确认位数匹配
  查下打包出来的程序是32位还是64位，必须和服务器上装的Python、VC++运行库位数完全一致，位数不匹配也会触发这种没明确提示的DLL加载失败。可以直接在服务器上开命令行，输python进交互环境，确认服务器本地装的Python本身能正常跑，排除基础Python环境损坏的问题。

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