[Error] LNK2019

오류 발생

2D 게임 프로젝트에서 Behavior Tree를 작성하고 몬스터 객체에 연결했는데 LNK2019 오류가 발생했다. 자주 봐서 친숙한 오류인데도 볼 때마다 머리가 지끈한 오류인 것 같다 ㅎ_ㅎ

이 오류는 코드상 오류는 없지만 컴파일러가 불평하는 경우이기 때문에 더 원인을 찾기 어려운 것 같다.

이번 포스트를 통해 LNK2019를 정복해보자!

---

오류 원인 및 해결 방법

1. 라이브러리 파일이 추가되지 않은 경우

• 원인
  • 프로젝트에서 외부 라이브러리를 사용하지만, 해당 라이브러리의 lib 파일이 링크되지 않았을 경우
  • 예를 들어, DirectX, OpenGL, FMOD 등과 같은 라이브러리를 사용할 때 이 오류가 발생할 수 있다.
• 해결 방법
  • 정적 라이브러리 추가하기 (두 가지 방법)
    1. Visual Studio에서 프로젝트 속성 → 링커 → 입력 → 추가 종속성에 .lib 파일 추가
    2. pragma comment(lib, "라이브러리.lib")를 코드에 직접 추가하기

---

2. main 함수가 정의되지 않은 경우

• 원인
  • main() 함수가 정의되지 않았거나 잘못된 형태로 작성된 경우
• 해결 방법
  • 콘솔 애플리케이라면 main()을 정의한다.
  • Windows 애플리케이션이라면 WinMain()을 정의한다.

---

3. 선언은 했지만 정의가 없는 경우

• 원인
  • 헤더 파일에 함수나 클래스가 선언되어 있지만, .cpp 파일에서 구현되지 않았을 경우
  • 특히 생성자, 소멸자가 정의되지 않았을 때 자주 발생한다.
• 해결 방법
  • 해당 함수나 클래스를 .cpp 파일에 구현한다.

---

4. x86, x64가 아키텍처 혼합 빌드

• 원인
  • 프로젝트를 빌드할 때 x86(32비트)와 x64(64비트)가 혼합된 경우
  • 예를 들어 x64 프로젝트에서 x86 라이브러리를 사용하거나 반대의 경우 발생한다.
• 해결 방법
  • 솔루션 탐색기에서 프로젝트 속성 → 구성 관리자에서 모든 프로젝트가 동일한 아키텍처를 사용하는지 확인한다.
  • 사용하는 라이브러리(lib 파일)도 같은 아키텍처인지 확인한다.

---

오류 해결

내 오류는 3번 경우였다. 생성자와 소멸자를 선언만 하고, 정의를 하지 않았던 것이다. 정의를 추가하니 바로 오류가 해결됐다.

[헤더 파일]

class Node
{
public:
    Node();
    ~Node();
}

[구현 파일]

Node::Node() {}

Node::~Node() {}

앞으로 선언과 정의를 꼼꼼하게 확인하자!

---

참고 [ VS 삽질 ] 확인할 수 없는 외부 참조, 확인할 수 없는 외부 기호