context 패키지는 무엇에 사용되나요?

Question

Accepted Answer

**`context`** 패키지는 **취소 신호, 마감 시간(deadline), 요청 범위 값**을 API 경계와 goroutine 전반에 전달합니다. 연산의 수명을 제어하는 표준 메커니즘으로 — 특히 작업을 취소하고 함수 호출 체인 전반에 타임아웃을 전파하는 데 쓰입니다.

## 해결하는 핵심 문제

```text
하나의 요청이 여러 goroutine/함수에 걸쳐 작업을 시작(DB 쿼리, API 호출 등).
클라이언트가 연결을 끊거나 타임아웃이 걸리면, 그 모든 작업을 취소하여
goroutine이 쓸데없이 계속 실행되지 않게(자원 낭비/누수) 하고 싶음.
→ context가 "지금 멈춰" 신호를 전체 호출 체인에 전파.
```

## context 생성

```go
ctx := context.Background()          // 루트 context(트리의 최상위)
ctx := context.TODO()                 // 확실하지 않을 때 자리표시자

// 타임아웃과 함께 — 시간 후 자동 취소
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()                        // 항상 cancel을 호출해 자원 해제

// 수동 취소와 함께
ctx, cancel := context.WithCancel(context.Background())
// cancel()을 호출해 취소를 알림

// 마감 시간(특정 시각)과 함께
ctx, cancel := context.WithDeadline(ctx, time.Now().Add(time.Minute))
```

`WithTimeout`/`WithDeadline`/`WithCancel`은 취소할 수 있는 자식 context를 파생합니다; 자원을 해제하려면 반드시 `defer cancel()`을 해야 합니다.

## 취소에 응답

```go
func doWork(ctx context.Context) error {
    for {
        select {
        case <-ctx.Done():            // 취소되거나 타임아웃 시 발화
            return ctx.Err()           // context.Canceled 또는 DeadlineExceeded 반환
        case work := <-jobs:
            process(work)
        }
    }
}
```

함수는 `ctx.Done()`(취소 시 닫히는 channel)을 확인하고 즉시 멈춥니다 — 이것이 취소가 실제로 전파되는 방식입니다.

## 호출 체인을 통한 context 전달(관례)

```go
// ctx는 관례상 첫 번째 매개변수이며 이름은 ctx
func handler(ctx context.Context, ...) {
    data, err := fetchFromDB(ctx, id)   // 아래로 전달 — DB 호출이 취소를 존중
}
func fetchFromDB(ctx context.Context, id int) (...) {
    row := db.QueryRowContext(ctx, ...)  // 표준 라이브러리 API가 context를 받음
}
```

context는 첫 번째 매개변수로 호출 스택을 따라 흐르므로, 취소가 모든 계층(context를 받는 표준 라이브러리 DB/HTTP 호출 포함)에 도달합니다.

## 요청 범위 값(아껴서 사용)

```go
ctx = context.WithValue(ctx, requestIDKey, "abc-123")   // 값 첨부
id := ctx.Value(requestIDKey)                            // 하류에서 검색
// ⚠️ 요청 범위 메타데이터(요청 ID, 인증)용 — 일반 매개변수 전달용 아님
```

## 왜 중요한가

`context` 패키지는 견고하고 프로덕션급 Go 서비스를 작성하는 데 기본입니다 — goroutine과 API 경계 전반에서 **취소와 타임아웃**을 처리하는 표준적이고 관용적인 방법입니다.

그 주된 가치는 낭비되는 작업과 자원 누수를 방지하는 것입니다: 클라이언트가 연결을 끊거나, 마감이 지나거나, 서버가 종료될 때, context가 취소 신호를 전파하여 그 요청을 위해 생성된 모든 goroutine과 연산이 쓸데없이 실행되지 않고 즉시 멈추게 합니다(goroutine 누수의 핵심 방어책).

실제 Go에 만연합니다 — HTTP 서버, 데이터베이스 호출, gRPC, 대부분의 네트워크 라이브러리가 `context.Context`를 첫 번째 매개변수로 받습니다.

context 생성 방법(`WithTimeout`/`WithCancel`), 취소에 응답하는 방법(`<-ctx.Done()`), `cancel()` 호출 필수 규칙, 호출 체인에 context를 엮는 관례를 이해하는 것은 진지한 Go 백엔드 작업에 필수적이며 흔한 면접 주제입니다.