미들웨어 패턴
로깅과 인증을 위한 핸들러 연결
미들웨어 패턴은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
미들웨어란 무엇인가요
미들웨어는 핸들러의 업무 로직을 수정하지 않고 공통 관심사(로깅, 인증, 복구)를 추가하기 위해 http.Handler를 감싸는 함수입니다.
미들웨어 시그니처
미들웨어는 http.Handler를 받아 http.Handler를 반환하는 함수입니다:
type Middleware func(http.Handler) http.Handler간단한 로깅 미들웨어
핸들러가 실행되기 전과 후에 각 요청을 기록합니다:
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("done %s", r.URL.Path)
})
}미들웨어 연결
미들웨어를 중첩해 여러 미들웨어 계층을 적용합니다:
handler := Logger(Auth(RateLimit(myHandler)))
http.ListenAndServe(":8080", handler)미들웨어 체인 도우미
깊은 중첩 없이 미들웨어를 순서대로 적용하려면 체인 함수를 만드십시오:
func Chain(h http.Handler, m ...Middleware) http.Handler {
for i := len(m)-1; i >= 0; i-- {
h = m[i](h)
}
return h
}
// Usage: Chain(myHandler, Logger, Auth, RateLimit)인증 미들웨어
다음 핸들러를 호출하기 전에 인증을 확인하십시오. 토큰이 없거나 유효하지 않으면 즉시 401을 반환합니다.
func Auth(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if !isValid(token) {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
})
}패닉 복구 미들웨어
핸들러에서 발생한 패닉을 잡아 서버가 중단되지 않도록 합니다:
func Recovery(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
log.Printf("panic: %v", err)
http.Error(w, "Internal Server Error", 500)
}
}()
next.ServeHTTP(w, r)
})
}컨텍스트로 데이터 전달
미들웨어는 이후 핸들러에서 사용할 데이터를 요청 컨텍스트에 추가할 수 있습니다:
ctx := context.WithValue(r.Context(), userKey, user)
next.ServeHTTP(w, r.WithContext(ctx))응답 래퍼
ResponseWriter를 감싸 핸들러가 작성한 상태 코드를 캡처합니다:
type statusRecorder struct {
http.ResponseWriter
status int
}
func (r *statusRecorder) WriteHeader(code int) {
r.status = code
r.ResponseWriter.WriteHeader(code)
}순서가 중요함
미들웨어는 핸들러를 감싼 순서대로 실행됩니다. 인증은 속도 제한보다 먼저 실행해야 하며, 패닉 복구는 다른 미들웨어에서 발생한 패닉도 잡을 수 있도록 가장 바깥쪽에 배치해야 합니다.
라우트별 미들웨어와 전역 미들웨어
전역 미들웨어(로깅, 복구)는 전체 멀티플렉서에 적용하십시오. 라우트별 미들웨어(인증, 속도 제한)는 하위 라우터나 핸들러 래퍼를 사용해 특정 라우트 그룹에 적용하십시오.
빠른 확인
Go에서 HTTP 미들웨어의 올바른 시그니처는 무엇인가요?
복습: 미들웨어 패턴
핵심 내용:
- 미들웨어: func(http.Handler) http.Handler
- 중첩해서 연결하고, 명확성을 위해 Chain 도우미 사용
- Recovery는 가장 바깥쪽에 배치하고, 업무 로직 전에 Auth 실행
- 컨텍스트를 통해 이후 단계로 데이터 전달
자주 묻는 질문
“미들웨어 패턴” 강의는 무료인가요?
네 — “미들웨어 패턴” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“미들웨어 패턴”에서 뭘 배우나요?
로깅과 인증을 위한 핸들러 연결 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“미들웨어 패턴” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.