Previous
Next
C++ RAII & Smart Pointers | '스마트 포인터' 가이드

C++ RAII & Smart Pointers | '스마트 포인터' 가이드

· 12분 읽기 · 수정 중급 튜토리얼
C++ RAII & Smart Pointers | '스마트 포인터' 가이드

이 글의 핵심

C++ RAII & Smart Pointers - "스마트 포인터" 가이드. C++ RAII & Smart Pointers의 RAII와 스마트 포인터란?, unique_ptr, shared_ptr를 실전 코드와 함께 설명합니다.

RAII와 스마트 포인터란?

RAII (Resource Acquisition Is Initialization) 는 자원 획득은 초기화라는 C++ 핵심 원칙으로, 객체 생성 시 자원을 획득하고 소멸 시 자동 해제합니다. 스마트 포인터는 RAII를 구현한 대표적인 예입니다.

C/C++ 예제 코드입니다.

// ❌ 수동 관리
int* ptr = new int(10);
// ....예외 발생 시 누수
delete ptr;

// ✅ 스마트 포인터
auto ptr = std::make_unique<int>(10);
// 자동 소멸

왜 필요한가?:

  • 자동 해제: 소멸자에서 자동 정리
  • 예외 안전: 예외 발생 시에도 안전
  • 메모리 누수 방지: delete 누락 방지
  • 소유권 명확: 누가 자원을 소유하는지 명확
// ❌ 수동 관리: 예외 시 누수
void func() {
    int* ptr = new int(10);
    
    if (error) {
        throw std::runtime_error("에러");  // 누수!
    }
    
    delete ptr;
}

// ✅ RAII: 예외 안전
void func() {
    auto ptr = std::make_unique<int>(10);
    
    if (error) {
        throw std::runtime_error("에러");  // 자동 해제
    }
}

RAII 동작 원리:

다음은 mermaid 예제 코드입니다.

flowchart LR
    A[객체 생성] --> B[자원 획득]
    B --> C[사용]
    C --> D[예외 발생?]
    D -->|Yes| E[스택 되감기]
    D -->|No| F[정상 종료]
    E --> G[소멸자 호출]
    F --> G
    G --> H[자원 해제]

스마트 포인터 종류:

타입소유권복사이동사용 시나리오
unique_ptr독점❌✅단일 소유자
shared_ptr공유✅✅여러 소유자
weak_ptr없음✅✅순환 참조 방지
// unique_ptr: 독점 소유권
std::unique_ptr<int> u = std::make_unique<int>(10);
// auto u2 = u;  // 에러: 복사 불가
auto u2 = std::move(u);  // OK: 이동

// shared_ptr: 공유 소유권
std::shared_ptr<int> s = std::make_shared<int>(10);
auto s2 = s;  // OK: 복사 (참조 카운트 증가)

// weak_ptr: 관찰만
std::weak_ptr<int> w = s;
if (auto ptr = w.lock()) {  // 사용 시 lock
    std::cout << *ptr << '\n';
}

unique_ptr

C/C++ 예제 코드입니다.

#include <memory>

// 독점 소유권
std::unique_ptr<int> ptr = std::make_unique<int>(10);

// 이동만 가능
auto ptr2 = std::move(ptr);  // ptr은 nullptr

shared_ptr

// 공유 소유권
std::shared_ptr<int> ptr1 = std::make_shared<int>(10);
std::shared_ptr<int> ptr2 = ptr1;  // 참조 카운트 증가

// 마지막 shared_ptr 소멸 시 자원 해제

실전 예시

예시 1: unique_ptr 기본

class Resource {
public:
    Resource() { std::cout << "생성" << std::endl; }
    ~Resource() { std::cout << "소멸" << std::endl; }
    
    void use() { std::cout << "사용" << std::endl; }
};

void func() {
    auto ptr = std::make_unique<Resource>();
    ptr->use();
    // 함수 종료 시 자동 소멸
}

int main() {
    func();
    // "생성" -> "사용" -> "소멸"
}

예시 2: shared_ptr 참조 카운트

func 함수의 구현 예제입니다.

void func() {
    auto ptr1 = std::make_shared<int>(10);
    std::cout << "카운트: " << ptr1.use_count() << std::endl;  // 1
    
    {
        auto ptr2 = ptr1;
        std::cout << "카운트: " << ptr1.use_count() << std::endl;  // 2
    }
    
    std::cout << "카운트: " << ptr1.use_count() << std::endl;  // 1
}

예시 3: 컨테이너

std::vector<std::unique_ptr<Widget>> widgets;

widgets.push_back(std::make_unique<Widget>(1));
widgets.push_back(std::make_unique<Widget>(2));

// 벡터 소멸 시 모든 Widget 자동 소멸

예시 4: 팩토리 패턴

class Shape {
public:
    virtual void draw() = 0;
    virtual ~Shape() = default;
};

class Circle : public Shape {
public:
    void draw() override {
        std::cout << "Circle" << std::endl;
    }
};

std::unique_ptr<Shape> createShape(const std::string& type) {
    if (type == "circle") {
        return std::make_unique<Circle>();
    }
    return nullptr;
}

weak_ptr

auto shared = std::make_shared<int>(10);
std::weak_ptr<int> weak = shared;

// 사용 시 lock
if (auto ptr = weak.lock()) {
    std::cout << *ptr << std::endl;
}

자주 발생하는 문제

문제 1: 순환 참조

// ❌ 순환 참조
class Node {
public:
    std::shared_ptr<Node> next;
    std::shared_ptr<Node> prev;  // 순환 참조
};

// ✅ weak_ptr 사용
class Node {
public:
    std::shared_ptr<Node> next;
    std::weak_ptr<Node> prev;  // 순환 방지
};

문제 2: this 포인터

// ❌ this를 shared_ptr로
class Bad {
public:
    std::shared_ptr<Bad> getPtr() {
        return std::shared_ptr<Bad>(this);  // 위험!
    }
};

// ✅ enable_shared_from_this
class Good : public std::enable_shared_from_this<Good> {
public:
    std::shared_ptr<Good> getPtr() {
        return shared_from_this();
    }
};

문제 3: 배열

C/C++ 예제 코드입니다.

// ❌ 배열 삭제 문제
std::unique_ptr<int> ptr(new int[10]);  // delete 호출

// ✅ 배열 특수화
std::unique_ptr<int[]> ptr(new int[10]);  // delete[] 호출

// ✅ make_unique (C++14)
auto ptr = std::make_unique<int[]>(10);

문제 4: 커스텀 삭제자

// FILE* 관리
auto deleter =  {
    if (f) fclose(f);
};

std::unique_ptr<FILE, decltype(deleter)> file(
    fopen("file.txt", "r"), deleter
);

성능 비교

// unique_ptr: 포인터 크기
sizeof(std::unique_ptr<int>);  // 8바이트

// shared_ptr: 포인터 + 제어 블록
sizeof(std::shared_ptr<int>);  // 16바이트

실무 패턴

패턴 1: 팩토리 함수

class Connection {
public:
    Connection(const std::string& host) : host_(host) {
        std::cout << "연결: " << host_ << '\n';
    }
    
    ~Connection() {
        std::cout << "연결 종료: " << host_ << '\n';
    }
    
    void query(const std::string& sql) {
        std::cout << "쿼리: " << sql << '\n';
    }
    
private:
    std::string host_;
};

std::unique_ptr<Connection> createConnection(const std::string& host) {
    return std::make_unique<Connection>(host);
}

// 사용
auto conn = createConnection("localhost");
conn->query("SELECT * FROM users");
// 자동 연결 종료

패턴 2: 캐시 시스템

#include <map>
#include <memory>
#include <string>

class Cache {
    std::map<std::string, std::weak_ptr<Resource>> cache_;
    
public:
    std::shared_ptr<Resource> get(const std::string& key) {
        // 캐시 확인
        if (auto it = cache_.find(key); it != cache_.end()) {
            if (auto ptr = it->second.lock()) {
                return ptr;  // 캐시 히트
            }
        }
        
        // 캐시 미스: 새로 생성
        auto resource = std::make_shared<Resource>(key);
        cache_[key] = resource;
        return resource;
    }
};

패턴 3: 소유권 전달

class TaskQueue {
    std::vector<std::unique_ptr<Task>> tasks_;
    
public:
    void addTask(std::unique_ptr<Task> task) {
        tasks_.push_back(std::move(task));
    }
    
    std::unique_ptr<Task> getNextTask() {
        if (tasks_.empty()) {
            return nullptr;
        }
        
        auto task = std::move(tasks_.back());
        tasks_.pop_back();
        return task;
    }
};

// 사용
TaskQueue queue;
queue.addTask(std::make_unique<Task>("Task1"));

auto task = queue.getNextTask();  // 소유권 이동
task->execute();

FAQ

Q1: 언제 사용하나요?

A:

  • unique_ptr: 독점 소유권, 단일 소유자
  • shared_ptr: 공유 소유권, 여러 소유자
  • weak_ptr: 순환 참조 방지, 관찰만

C/C++ 예제 코드입니다.

// unique_ptr: 독점
std::unique_ptr<Widget> widget = std::make_unique<Widget>();

// shared_ptr: 공유
std::shared_ptr<Widget> shared = std::make_shared<Widget>();
auto shared2 = shared;  // 복사

// weak_ptr: 관찰
std::weak_ptr<Widget> weak = shared;

Q2: 성능은?

A:

  • unique_ptr: raw pointer와 동일 (오버헤드 없음)
  • shared_ptr: 참조 카운트 오버헤드 (원자적 연산)
// unique_ptr: 8바이트
sizeof(std::unique_ptr<int>);  // 8

// shared_ptr: 16바이트 (포인터 + 제어 블록)
sizeof(std::shared_ptr<int>);  // 16

Q3: 배열은 어떻게 사용하나요?

A: unique_ptr<T[]> 를 사용합니다.

C/C++ 예제 코드입니다.

// ❌ 배열 삭제 문제
std::unique_ptr<int> ptr(new int[10]);  // delete 호출 (잘못됨)

// ✅ 배열 특수화
std::unique_ptr<int[]> ptr(new int[10]);  // delete[] 호출

// ✅ make_unique (C++14)
auto ptr = std::make_unique<int[]>(10);

Q4: 순환 참조는 어떻게 해결하나요?

A: weak_ptr 로 해결합니다.

// ❌ 순환 참조
class Node {
    std::shared_ptr<Node> next;
    std::shared_ptr<Node> prev;  // 순환 참조
};

// ✅ weak_ptr
class Node {
    std::shared_ptr<Node> next;
    std::weak_ptr<Node> prev;  // 순환 방지
};

Q5: 언제 raw pointer를 사용하나요?

A:

  • 소유권 없음: 관찰만
  • 함수 매개변수: 임시 참조
  • 성능 중요: 핫 패스

process 함수의 구현 예제입니다.

// raw pointer: 소유권 없음
void process(Widget* widget) {
    widget->use();  // 관찰만
}

// unique_ptr: 소유권 있음
std::unique_ptr<Widget> owner = std::make_unique<Widget>();
process(owner.get());  // raw pointer 전달

Q6: make_unique vs new?

A: make_unique를 권장합니다.

C/C++ 예제 코드입니다.

// ❌ new: 예외 안전하지 않음
func(std::unique_ptr<Widget>(new Widget()), compute());
// compute()에서 예외 발생 시 누수 가능

// ✅ make_unique: 예외 안전
func(std::make_unique<Widget>(), compute());

Q7: 커스텀 삭제자는?

A: 람다나 함수 객체를 사용합니다.

// FILE* 관리
auto deleter =  {
    if (f) fclose(f);
};

std::unique_ptr<FILE, decltype(deleter)> file(
    fopen("file.txt", "r"), deleter
);

Q8: 스마트 포인터 학습 리소스는?

A:

관련 글: unique_ptr, shared_ptr, weak_ptr.

한 줄 요약: RAII와 스마트 포인터는 자동 자원 관리로 메모리 누수를 방지하는 C++ 핵심 기법입니다.

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

관련 글

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「C++ RAII & Smart Pointers | ‘스마트 포인터’ 가이드」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]
sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)
  • 불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
  • 결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
  • 경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
  • 백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역운영 관점 질문
관측성요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「C++ RAII & Smart Pointers | ‘스마트 포인터’ 가이드」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

  1. 입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
  2. 핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
  3. 실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
  4. 호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
  5. 부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.
handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상가능 원인조치
간헐적 실패레이스, 타임아웃, 외부 의존성, DNS최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패환경 변수, 권한, 플랫폼 차이, lockfileCI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치프로필·시크릿·기본값, 리전스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치비멱등 재시도, 부분 쓰기, 캐시 무효화 누락멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git add → git commit → git push 후 npm run deploy 순서를 권장합니다.

이 글에서 다루는 키워드 (관련 검색어)

C++, RAII, smart-pointers, unique_ptr, shared_ptr 등으로 검색하시면 이 글이 도움이 됩니다.