问题：LoadLibrary加载DLL失败，提示错误87参数错误如何解决？

Question

在使用 `LoadLibrary` 加载 DLL 时出现错误 87（参数错误），通常是由于传入的 DLL 路径无效或格式不正确所致。常见原因包括路径包含非法字符、路径过长、文件名拼写错误或未正确使用宽字符（Unicode）版本的函数。解决方法包括：检查路径字符串是否正确，建议使用绝对路径；确保路径中不含控制字符或空格导致解析失败；使用 `GetLastError` 进一步确认具体错误；在 Unicode 编译环境下应使用 `LoadLibraryW` 或在字符串前加 `_T` 宏；还可尝试使用 `SetLastError(0)` 前置清空错误码以提高排查准确性。

Answer 1

一、LoadLibrary 加载 DLL 时出现错误 87 的背景与现象

在 Windows 平台的开发中，使用 LoadLibrary 函数加载动态链接库（DLL）是一个常见的操作。但有时会遇到错误码 87，即 ERROR_INVALID_PARAMETER，表示传入的参数不合法。

错误 87 是一个通用的参数错误提示，具体原因可能涉及路径格式、编码方式、路径长度、拼写错误等。该问题在 Unicode 编译环境下尤为常见。

二、LoadLibrary 错误 87 的常见原因分析

• 路径中包含非法字符，如控制字符、特殊符号等。
• 路径长度超过系统限制（MAX_PATH = 260）。
• 文件名拼写错误或路径不存在。
• 未正确使用 Unicode 版本函数（LoadLibraryW）或未使用 _T 宏。
• 路径中包含空格或未使用引号包裹导致解析失败。

三、排查 LoadLibrary 错误 87 的步骤与流程

为提高排查效率，建议按以下流程逐步分析：

graph TD
    A[调用 LoadLibrary] --> B{是否设置 SetLastError(0)?}
    B -- 是 --> C[执行 LoadLibrary]
    C --> D{返回 NULL?}
    D -- 是 --> E[调用 GetLastError()]
    E --> F{是否为 87?}
    F -- 是 --> G[检查路径格式]
    G --> H[使用绝对路径]
    H --> I[检查路径长度]
    I --> J[检查 Unicode 使用]
    J --> K[重新尝试加载]
    D -- 否 --> L[其他错误处理]
    B -- 否 --> M[建议前置 SetLastError(0)]
    

四、解决 LoadLibrary 错误 87 的技术方案

问题点	解决方案
非法字符	检查路径中是否包含控制字符、斜杠错误等
路径过长	启用长路径支持（Windows 10 1607+）或使用绝对路径
拼写错误	使用 PathFileExists 或 GetFileAttributes 验证文件存在性
编码问题	使用 LoadLibraryW 或 _T("dllpath") 宏
空格或特殊路径	使用引号包裹路径，如 "C:\\My App\\my.dll"

五、代码示例：正确使用 LoadLibraryW 加载 DLL

以下是一个使用宽字符版本加载 DLL 的示例代码：

#include <windows.h>
#include <stdio.h>

int main() {
    SetLastError(0);
    LPCWSTR dllPath = L"C:\\MyApp\\MyLibrary.dll";
    HMODULE hModule = LoadLibraryW(dllPath);
    if (hModule == NULL) {
        DWORD error = GetLastError();
        wprintf(L"LoadLibrary failed with error %lu\n", error);
    } else {
        wprintf(L"DLL loaded successfully.\n");
        FreeLibrary(hModule);
    }
    return 0;
}
    

六、深入理解 LoadLibraryW 与 LoadLibraryA 的区别

在 Unicode 编译环境下，LoadLibrary 实际上是 LoadLibraryW 的宏定义，使用宽字符（UTF-16）进行路径处理。若使用 ANSI 版本（LoadLibraryA），路径会被转换为多字节字符，可能导致解析失败。

建议始终使用 LoadLibraryW 或配合 _T 宏（如 _T("my.dll")）以确保兼容性。

七、进阶技巧：使用调试工具辅助排查 LoadLibrary 问题

可使用以下工具辅助分析：

• Process Monitor：监控 DLL 加载路径及失败原因。
• Dependency Walker：分析 DLL 依赖关系和加载失败原因。
• Windbg：调试加载过程，查看调用堆栈和错误码。

这些工具可以帮助定位路径解析、权限不足、依赖缺失等问题。