Windows下编译可供Raku NativeCall调用的DLL库出现error 0xc1报错的问题
问题根因
- 报错信息里的
error 0xc1对应Windows系统错误ERROR_BAD_EXE_FORMAT,代表当前要加载的DLL文件格式和Raku进程的要求不匹配;而显示的Cannot locate native library '(null)'并不是真的找不到你写的DLL路径,是因为DLL加载失败后,NativeCall拿到的模块句柄为空,所以用(null)做占位文本。 - 最常见的触发原因是32/64位不匹配:你打开的VS 2019开发者命令提示符如果是默认的x86 32位环境,编译出的就是32位DLL;如果你的Rakudo是64位版本,完全无法加载32位DLL,就会直接报这个格式错误。
- 手动分两步跑编译、链接命令的流程有缺陷:手动执行
cl /c生成obj后再单独跑link /DLL,很容易漏掉C运行库的自动链接参数,导致生成的DLL导入表不完整,无法正常加载。 - 代码写法存在冗余问题:定义了
EXPORTED宏但没在实际函数定义上使用,仅靠extern声明加导出标记,容易出现声明和定义的属性不一致问题。 - 其他触发场景:如果生成的DLL缺少对应版本的VC运行库依赖,也会因为无法解析依赖项导致加载失败,出现同样的报错。
解决操作步骤
- 第一步:确认Rakudo的位宽
在系统命令行执行raku -e "$*VM.config<arch>",根据输出结果确定编译的目标位宽:- 输出
MSWin32-x64则必须编译64位DLL - 输出
MSWin32-x86则必须编译32位DLL
- 输出
- 第二步:打开对应位宽的VS编译环境
关闭当前打开的开发者命令提示符,从VS 2019开始菜单里选择匹配位宽的命令提示符快捷方式:- 64位目标选"x64 Native Tools Command Prompt for VS 2019"
- 32位目标选"x86 Native Tools Command Prompt for VS 2019"
- 第三步:修正C代码的导出写法
把my_c_dll.c里的冗余内容删掉,改成直接在函数定义上加导出标记的规范写法:#include <stdio.h> __declspec(dllexport) void foo() { printf("Hello from C\n"); } - 第四步:单步编译生成DLL
不要分开手动跑cl /c和link /DLL,直接在对应环境的命令行执行单条编译命令,让编译器自动处理所有链接依赖:
参数说明:cl /LD my_c_dll.c /Fe:my_c_dll.dll/LD会自动完成DLL所需的编译、链接全流程,不需要手动拆分步骤/Fe指定最终输出的DLL文件名称- 可选优化:如果希望避免C运行库的外部依赖,可以给编译命令加上
/MT参数静态链接CRT,生成的DLL无需额外安装VC运行库即可运行。
- 第五步:验证DLL导出表
执行dumpbin /exports my_c_dll.dll,确认导出函数列表里存在foo函数,没有导出异常。 - 第六步:运行Raku测试脚本
保持test-dll.raku里的native路径写法不变(./my_c_dll.dll会优先匹配当前工作目录下的DLL,写法正确),执行raku test-dll.raku,即可正常看到C函数打印的Hello from C输出。
内容的提问来源于stack exchange,提问作者Håkon Hægland
相关产品推荐
相关产品推荐

