Go Academy · 강의

HTTP 미들웨어 체인 기초

http.Handler를 감싸고 next로 연결합니다.

HTTP 미들웨어 체인 기초은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

net/http의 미들웨어

Go 표준 라이브러리에서 미들웨어는 http.Handler를 받아 원래 처리기를 추가 동작으로 감싼 새로운 http.Handler를 반환하는 함수입니다.

type Middleware func(http.Handler) http.Handler

기본 미들웨어

내부 HandlerFunc가 원래 처리기를 사전 및 사후 로직으로 감쌉니다:

func Logger(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("→ %s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
        log.Printf("← %s %s done", r.Method, r.URL.Path)
    })
}

미들웨어 적용

멀티플렉서에 등록하기 전에 처리기를 감쌉니다:

mux := http.NewServeMux()
mux.Handle("/api/", Logger(Auth(apiHandler)))
http.ListenAndServe(":8080", mux)

미들웨어 체인 도우미

Chain 함수는 여러 미들웨어를 읽기 쉬운 왼쪽에서 오른쪽 순서로 적용합니다:

func Chain(h http.Handler, ms ...func(http.Handler) http.Handler) http.Handler {
    for i := len(ms)-1; i >= 0; i-- { h = ms[i](h) }
    return h
}
// Usage: Chain(handler, Logger, Auth, RateLimit)

미들웨어의 Context

파생 Context를 만들고 요청을 감싸 요청 범위 값을 연결합니다:

func RequestID(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        id := uuid.New().String()
        ctx := context.WithValue(r.Context(), reqIDKey, id)
        w.Header().Set("X-Request-ID", id)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

응답 작성기 래퍼

ResponseWriter를 감싸 처리기가 작성한 상태 코드를 캡처합니다:

type captureWriter struct {
    http.ResponseWriter
    status int
}
func (cw *captureWriter) WriteHeader(code int) {
    cw.status = code
    cw.ResponseWriter.WriteHeader(code)
}

패닉 복구 미들웨어

서버가 충돌하지 않도록 패닉을 복구합니다:

func Recovery(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if rec := recover(); rec != nil {
                http.Error(w, "Internal Server Error", 500)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

순서가 중요합니다

미들웨어는 처리기를 감싸는 순서대로 실행됩니다. Recovery는 가장 바깥쪽에 있어야 합니다(모든 항목을 감쌉니다). 인증은 비즈니스 로직보다 먼저 적용합니다. 로그 기록은 일반적으로 Recovery 다음의 가장 바깥쪽에 적용합니다.

타사 라우터와의 호환성

미들웨어가 표준 func(http.Handler) http.Handler 시그니처를 따르므로 chi, gorilla/mux 및 http.Handler를 허용하는 모든 라우터와 호환됩니다.

전역과 라우트별 설정 비교

전체 멀티플렉서에 전역으로 미들웨어를 적용하거나, 라우트별 동작을 위해 개별 처리기를 감쌉니다. chi의 하위 라우터를 사용하면 그룹 수준 미들웨어를 더 깔끔하게 구성할 수 있습니다.

미들웨어 테스트

httptest.NewRecorder와 httptest.NewRequest를 사용하면 실제 서버를 시작하지 않고 미들웨어를 독립적으로 테스트할 수 있습니다.

w := httptest.NewRecorder()
r := httptest.NewRequest("GET", "/", nil)
Logger(http.HandlerFunc(noop)).ServeHTTP(w, r)

빠른 확인

표준 net/http 미들웨어 시그니처는 무엇입니까?

요약: 미들웨어 체인

핵심 내용:

func(http.Handler) http.Handler가 표준 시그니처입니다
깊은 중첩을 피하려면 Chain 도우미를 사용합니다
r.WithContext(ctx)로 값을 연결하고, 캡처 작성기로 상태를 기록합니다
Recovery는 가장 바깥쪽에, 인증은 비즈니스 로직 전에, 로그 기록은 Recovery 다음에 적용합니다

자주 묻는 질문

“HTTP 미들웨어 체인 기초” 강의는 무료인가요?

네 — “HTTP 미들웨어 체인 기초” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“HTTP 미들웨어 체인 기초”에서 뭘 배우나요?

http.Handler를 감싸고 next로 연결합니다. 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“HTTP 미들웨어 체인 기초” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기