VS导入FASM生成的DLL报LNK2019未解析外部符号错误排查

32位x86环境下MSVC链接器的stdcall符号修饰规则、DEF文件配置、FASM导出表三者不匹配，是报错的核心原因：

• 32位MSVC对__stdcall调用约定的函数会自动做符号修饰：函数名前加下划线前缀，后缀加@+参数占用栈空间的字节数。你声明的exp2接收1个DWORD类型参数（占4字节），使用__declspec(dllimport)时链接器会查找__imp__exp2@4这个导入符号；如果错误使用__declspec(dllexport)，链接器会查找本地实现符号_exp2@4。
• 你手写的DEF文件仅写了exp2@4，既没有匹配MSVC要求的下划线前缀修饰名，也没有做导出名映射，lib工具生成的导入库中根本不存在链接器需要的两个符号，必然触发未解析外部符号报错。
• FASM代码中导出的函数名是无任何修饰的exp2，和MSVC默认查找的修饰名不匹配，无法直接对应。

优先选修正DEF文件的方案，不需要改动FASM汇编代码：

• 重写DEF文件，显式配置符号映射，将MSVC需要的修饰名映射到DLL实际导出的函数名，内容如下：

LIBRARY fasmdll.dll
EXPORTS
_exp2@4=exp2

说明：等号左侧是MSVC链接器查找的修饰后的符号名，等号右侧是FASM导出表中实际存在的无修饰导出名，LIBRARY后的值需要和你实际生成的DLL文件名保持一致。

• 重新执行命令生成导入库即可：

lib /def:fasmdll.def /out:fasmdll.lib /machine:x86

• C++代码中保持正确的导入声明即可，不要错误使用__declspec(dllexport)：

#pragma comment(lib,"fasmdll.lib")
extern "C" __declspec(dllimport) void  __stdcall exp2(DWORD);

如果不想维护DEF文件，也可以直接修改FASM的导出配置，让DLL直接导出MSVC兼容的修饰名：

• 把FASM中导出段的代码改为：

section '.edata' export readable
export 'fasmdll.dll',exp2,'_exp2@4'

• 编译生成DLL后，不需要手写DEF，直接执行以下命令即可自动生成匹配的导入库：

lib /def:fasmdll.dll /out:fasmdll.lib /machine:x86

• __declspec(dllexport)是用于声明当前项目要对外导出的符号，不能用来引入外部DLL的函数，写错声明会导致链接器查找本地符号实现，触发另一种未解析报错。
• 该符号修饰问题仅存在于32位x86环境，x64架构下不存在stdcall名称修饰的兼容问题。

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