Cygwin64 Makefile编译的abc.dll无法被Node.js调用的求助

核心问题 #

你遇到的程序卡住问题，本质是GCC（Cygwin）编译的DLL和MSVC编译的DLL在调用约定、内存管理、运行时环境上存在差异——CLI程序xyz.exe和DLL同属Cygwin运行时环境所以能正常交互，但Node.js基于MSVC运行时，无法适配这些差异导致卡住。

具体解决步骤 #

1. 修正函数调用约定

GCC默认使用cdecl调用约定，而ffi-napi默认假设是Windows常用的stdcall，栈不平衡直接导致程序卡住。修改你的dummy.js，明确指定调用约定：

const ffi = require("ffi-napi");
const path = "C:\\Users\\Vt\\Desktop\\Frontend repo\\frontend\\src\\components\\dll\\abc.dll";
// 添加 { abi: 'cdecl' } 指定调用约定
const myDLL = ffi.Library(path, { 
  'listing': ['string', [], { abi: 'cdecl' }] 
});

function callDLLFunction() {
  return myDLL.listing();
}

module.exports = {myDLL}
console.log(callDLLFunction());

2. 统一字符串内存分配方式

GCC在Cygwin堆上分配的字符串，Node.js（基于MSVC运行时）无法正确访问或释放，会导致阻塞。有两种可行方案：

• 方案一：返回静态字符串（适合简单场景）
  在DLL的listing函数里直接返回静态常量，避免动态内存分配问题：

  __declspec(dllexport) char* __cdecl listing() {
      printf("Calling listing method\n");
      fflush(stdout); // 强制刷新输出，避免缓冲看不到日志
      return "C:\\"; // 静态字符串无需手动释放
  }
  

• 方案二：用Windows API分配内存
  改用LocalAlloc在Windows系统堆上分配内存，Node.js可以正确识别并处理：

  #include <windows.h>
  __declspec(dllexport) char* __cdecl listing() {
      printf("Calling listing method\n");
      fflush(stdout);
      char* driveStr = (char*)LocalAlloc(LPTR, MAX_PATH);
      GetLogicalDriveStrings(MAX_PATH, driveStr);
      return driveStr;
  }
  

3. 确保Cygwin运行时依赖存在

Cygwin编译的DLL依赖cygwin1.dll，如果Node.js进程找不到这个库，会静默失败：

• 把Cygwin的bin目录（比如C:\cygwin64\bin）添加到系统PATH环境变量
• 或者直接把cygwin1.dll复制到abc.dll所在的目录下

4. 编译DLL时添加Windows兼容参数

编译时给GCC加参数，让生成的DLL更贴近Windows原生DLL规范：

gcc -shared -o abc.dll your_source_code.c -Wl,--add-stdcall-alias -mwindows

• -Wl,--add-stdcall-alias：给cdecl函数自动添加stdcall别名，增强兼容性
• -mwindows：避免链接控制台相关依赖，减少运行时冲突

5. 调试验证

如果还是卡住，先确认DLL函数是否真的被调用：

• 在DLL的listing函数里加fflush(stdout);，强制刷新printf的输出
• 用Windows的DebugView工具捕获系统输出，查看是否有Calling listing method日志，确认函数是否执行

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