정적 라이브러리 참조 시 "LNK2019 unresolved external symbol '...' referenced in function" 오류 발생
우연히 접하게 된 라이브러리 하나가 재미있는 구조로 되어 있습니다. ^^ 기본적으로는 C 정적 라이브러리인데, Win32 DLL로도 컴파일이 가능하게 소스코드가 유연하게 구성되어 있는데요.
실제로 간단하게 하나 만들어 보겠습니다. 정적 라이브러리 용도로 Win32 프로젝트를 선택해 다음과 같이 함수 하나를 추가해 둡니다.
// ================= My.h ===============
#pragma once
#if defined(_MSC_VER) && defined(_USRDLL)
# ifdef LIB_EXPORTS
# define LIB_DLLEXTERN __declspec(dllexport)
# else
# define LIB_DLLEXTERN __declspec(dllimport)
# endif
#else
# define LIB_DLLEXTERN
#endif
#ifdef __cplusplus
extern "C"
{
#endif
LIB_DLLEXTERN int MyFunc(int input);
#ifdef __cplusplus
};
#endif
// ================= My.c ===============
#include "My.h"
LIB_DLLEXTERN int MyFunc(int input)
{
return input + 5;
}
보시는 바와 같이, Win32 정적 프로젝트(이름: StaticLib)이므로 LIB_DLLEXTERN은 빈 매크로로 설정됩니다. 반면 만약 이 소스코드를 Win32 DLL 프로젝트에 추가해 LIB_DLLEXTERN 상수와 함께 컴파일하면 __declspec(dllexport) 영향으로 MyFunc 함수가 외부로 노출이 가능해집니다.
이 함수를 이용하는 Win32 Console EXE 프로젝트를 만들어 테스트 해보면 당연히 잘 컴파일이 됩니다. (정적으로 링크됩니다.)
#include "stdafx.h"
#include "../StaticLib/My.h"
int main()
{
int result = MyFunc(5);
printf("%d\n", result);
return 0;
}
문제는, 위의 정적 라이브러리를 Win32 DLL 프로젝트에서 참조할 때 발생합니다.
#include "stdafx.h"
#include "Win32Lib.h"
#include "../StaticLib/My.h"
WIN32LIB_API int fnWin32Lib(void)
{
int result = MyFunc(5);
return result;
}
StaticLib 정적 라이브러리를 추가한 Win32 DLL 프로젝트를 빌드하면 다음과 같은 링크 오류가 발생합니다.
Creating library C:\staticlib\x64\Debug\Win32Lib.lib and object C:\staticlib\x64\Debug\Win32Lib.exp
Win32Lib.obj : error LNK2019: unresolved external symbol __imp_MyFunc referenced in function "int __cdecl fnWin32Lib(void)" (?fnWin32Lib@@YAHXZ)
C:\staticlib\x64\Debug\Win32Lib.dll : fatal error LNK1120: 1 unresolved externals
문제를 간단히 했으니 쉽게 유추할 수 있지만, 수많은 소스 코드 파일을 담은 3rd-party 라이브러리를 정적 링크할 때 저런 오류가 나오면 도대체 뭐가 잘못된 것인지 ^^; 헤맬 수밖에 없습니다.
원인은 간단합니다. My.h 헤더 파일을 include한 Win32 DLL 프로젝트는 _USRDLL 상수가 정의되어 있으므로 __declspec(dllimport) 구문이 정의되어 버립니다.
#pragma once
#if defined(_MSC_VER) && defined(_USRDLL)
# ifdef LIB_EXPORTS
# define LIB_DLLEXTERN __declspec(dllexport)
# else
# define LIB_DLLEXTERN __declspec(dllimport)
# endif
#else
# define LIB_DLLEXTERN
#endif
#ifdef __cplusplus
extern "C"
{
#endif
LIB_DLLEXTERN int MyFunc(int input);
#ifdef __cplusplus
};
#endif
따라서, DLL 프로젝트 측에서는 "__declspec(dllimport) int MyFunc(int input);" 시그니처를 가진 함수를 찾으려고 시도하지만 링커는 정적 라이브러리 파일(.lib)로부터 그 함수를 찾을 수 없으므로 LNK2019 오류를 내뱉는 것입니다.
문제의 원인을 좀 더 자세히 설명해보면!
"__declspec(dllimport)"로 인해 calling convention이 바뀌는 것은 아닙니다. 단지 dllimport가 지정된 경우 Visual C++ 컴파일러는 그것이 DLL로부터 export된 함수라고 가정하고 DLL 컴파일 시에 생성된 Import Library의 정보를 바탕으로 링크를 시도하는데 이때 해당 .lib 파일에 정의된 이름이 "__imp_[function]" 과 같은 식으로 정의됩니다. 하지만, 우리가 제공했던 .lib 파일은 DLL의 Import Lib 파일이 아닌 순수 정적 링크를 위한 .lib 파일이기 때문에 __imp_.... 식의 이름을 포함하고 있지 않아 LNK2019 오류로 이어진 것입니다.
어찌 보면, 정적 라이브러리 파일과 (DLL의) Import 라이브러리 파일의 확장자를 동일하게 해버려서 온 혼란의 하나겠지요!
해결 방법은, 추가하려는 정적 파일의 헤더 파일을 수정하거나... 아니면 다음과 같이 임시로 _USRDLL 상수를 해제해 버리면 됩니다.
#include "stdafx.h"
#include "Win32Lib.h"
#undef _USRDLL
#include "../StaticLib/My.h"
WIN32LIB_API int fnWin32Lib(void)
{
int result = MyFunc(5);
return result;
}
(
첨부한 파일은 이 글의 재현 코드입니다.)
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]