C++跨EXE/DLL边界传递GLFWwindow指针调用返回值异常排查

根因排查优先级排序 #

• 最高概率：GLFW库实例不匹配
  这是Windows下跨模块传C库内部对象最常见的问题。GLFW内部维护了全局的窗口状态注册表，如果你在EXE和自定义DLL中分别静态链接了GLFW，两个模块会各自持有独立的GLFW全局状态副本：
  • DLL内创建GLFWwindow时，对象只会注册到DLL链接的那份GLFW的全局状态中
  • EXE调用glfwGetFramebufferSize时，走的是EXE自己链接的GLFW逻辑，它的全局状态表里根本没有这个窗口的记录，自然返回无效的0值
    这也完全匹配你观察到的现象：相同调用逻辑放在DLL内部执行时，走的是DLL那份GLFW的状态查询，就能拿到正确的宽高值。
    修复方式：统一EXE和自定义DLL的GLFW链接配置，两边都动态链接同一份GLFW官方DLL（glfw3.dll），禁止任意一边静态链接GLFW。
• 次高概率：编译配置不匹配
  如果已经统一动态链接GLFW，逐一核对两个项目的以下编译选项：
  • 运行时库选项完全一致：Debug模式统一用/MDd，Release模式统一用/MD，不要一边用静态CRT（/MT//MTd）一边用动态CRT，也不要混Debug和Release配置
  • 结构体对齐选项保持默认一致，不要单独给某个项目修改对齐参数，否则两个模块对GLFWwindow结构体的成员内存偏移解析会错乱
  • 两个项目包含的GLFW头文件版本完全一致，不同GLFW版本的GLFWwindow结构体成员布局有差异，混用会导致内存解析错误
• 低概率：调用约定/声明不匹配
  确认自定义DLL返回GLFWwindow*的接口使用默认__cdecl调用约定，不要错用__stdcall等其他约定导致栈传参异常。两个模块都必须通过官方glfw3.h头文件引入GLFW相关声明，不要自己手写GLFWwindow的前置声明或者自定义结构体定义。

快速验证流程 #

1. 移除EXE和自定义DLL项目中所有静态链接GLFW的配置，替换为同一份GLFW DLL对应的导入库链接项
2. 统一两个项目的运行时库编译选项
3. 清理所有中间编译产物、输出目录的旧DLL/EXE文件，全量重编后测试

注意：跨模块传递指针时，指针值非空不代表可以正常使用。对于维护全局状态的C库，只有两个模块共用同一份库的代码实例和全局状态时，库内部才能正确识别传入的指针对应的对象。

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