Go에서 HTTP 미들웨어를 만드는 방법은 무엇인가요?

Q1: Go에서 HTTP 미들웨어란 무엇인가요?
A1: HTTP 미들웨어는 HTTP 요청과 응답 사이에서 동작하는 함수나 핸들러로, 로깅, 인증, 권한 검사, 요청 조작 등 공통 기능을 재사용 가능하게 구현하는 패턴입니다.

Q2: Go에서 HTTP 미들웨어를 어떻게 정의하나요?
A2: 보통 `http.Handler` 또는 `http.HandlerFunc`을 입력으로 받고, 새로운 `http.Handler`를 반환하는 함수 형태로 정의합니다. 예를 들어:
```go
func Middleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 미들웨어 로직 (ex: 로깅, 인증)
next.ServeHTTP(w, r) // 다음 핸들러 호출
})
}
```

Q3: `http.Handler`와 `http.HandlerFunc`의 차이는 무엇인가요?
A3: `http.Handler`는 ServeHTTP 메서드를 가진 인터페이스이고, `http.HandlerFunc`은 `func(http.ResponseWriter, *http.Request)` 형식의 함수 타입으로 인터페이스를 구현합니다. `http.HandlerFunc`을 사용하면 함수 자체를 핸들러로 쉽게 사용할 수 있습니다.

Q4: 미들웨어를 어떻게 체인으로 연결하나요?
A4: 여러 미들웨어를 중첩하여 호출합니다. 예:
```go
finalHandler := http.HandlerFunc(final)
wrapped := Middleware1(Middleware2(finalHandler))
http.Handle("/path", wrapped)
```

Q5: 미들웨어 내부에서 요청을 차단하려면 어떻게 하나요?
A5: 조건에 따라 `next.ServeHTTP`를 호출하지 않고, 바로 응답을 작성하면 요청 처리를 중단할 수 있습니다. 예:
```go
if !authorized {
http.Error(w, "Forbidden", http.StatusForbidden)
return }
next.ServeHTTP(w, r)
```

Q6: 미들웨어에서 요청 컨텍스트를 사용하는 방법은?
A6: `r.WithContext`를 통해 새로운 컨텍스트로 교체한 후 `next.ServeHTTP`에 넘깁니다. 예:
```go
ctx := context.WithValue(r.Context(), key, value)
next.ServeHTTP(w, r.WithContext(ctx))
```

Q7: 표준 라이브러리 외에 인기 있는 미들웨어 라이브러리가 있나요?
A7: 네, `gorilla/mux`, `chi`, `negroni` 같은 라이브러리들이 미들웨어 관리를 쉽게 해줍니다.

Q8: 간단한 로깅 미들웨어 예제는 어떻게 되나요?
A8:
```go
func LoggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Printf("Started %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
log.Printf("Completed %s %s", r.Method, r.URL.Path)
})
}
```

Q9: 미들웨어에서 응답 헤더를 조작하려면?
A9: `w.Header().Set("Key", "Value")`로 설정 후 `next.ServeHTTP` 호출하면 됩니다.

Q10: 미들웨어를 테스트하는 권장 방법은?
A10: 테스트용 `http.Request`와 `httptest.ResponseRecorder`를 사용해 미들웨어 함수가 의도대로 동작하는지 확인합니다.

Go에서 HTTP 미들웨어를 만드는 것은 웹 애플리케이션의 요청 및 응답 처리 과정에서 공통적인 기능을 추가하는 데 매우 유용합니다.

미들웨어는 요청을 처리하기 전에 또는 응답을 반환하기 전에 특정 작업을 수행할 수 있도록 해줍니다.

예를 들어, 인증, 로깅, CORS 처리, 요청 수정, 응답 수정 등을 미들웨어를 통해 구현할 수 있습니다.

미들웨어의 기본 구조 Go에서 미들웨어는 일반적으로 `http.Handler` 인터페이스를 구현하는 함수로 정의됩니다.

`http.Handler` 인터페이스는 `ServeHTTP` 메서드를 가지고 있으며, 이 메서드는 HTTP 요청을 처리하는 데 사용됩니다.

미들웨어는 기존 핸들러를 감싸는 형태로 구현됩니다.

미들웨어 구현 예제 아래는 간단한 로깅 미들웨어의 예제입니다.

이 미들웨어는 요청이 들어올 때마다 요청 메서드와 URL을 로그로 출력합니다.

```go package main import ( "fmt" "net/http" "time" ) // LoggingMiddleware는 요청을 로깅하는 미들웨어입니다.

func LoggingMiddleware(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { start := time.Now() fmt.Printf("Request: %s %s\n", r.Method, r.URL.Path) // 다음 핸들러 호출 next.ServeHTTP(w, r) // 요청 처리 시간 로그 duration := time.Since(start) fmt.Printf("Processed in %v\n", duration) }) } // HelloHandler는 간단한 핸들러입니다.

func HelloHandler(w http.ResponseWriter, r *http.Request) { fmt.Fprintln(w, "Hello, World!") } func main() { mux := http.NewServeMux() mux.Handle("/", HelloHandler) // 미들웨어 적용 loggedMux := LoggingMiddleware(mux) // 서버 시작 http.ListenAndServe(":8080", loggedMux) } ``` 미들웨어 체이닝 여러 개의 미들웨어를 체이닝하여 사용할 수 있습니다.

이를 위해 각 미들웨어는 다음 미들웨어를 호출하는 방식으로 구현됩니다.

아래는 인증 미들웨어와 로깅 미들웨어를 함께 사용하는 예제입니다.

```go // AuthMiddleware는 인증을 처리하는 미들웨어입니다.

func AuthMiddleware(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { // 인증 로직 (예: 토큰 확인) token := r.Header.Get("Authorization") if token != "valid-token" { http.Error(w, "Unauthorized", http.StatusUnauthorized) return } // 다음 핸들러 호출 next.ServeHTTP(w, r) }) } func main() { mux := http.NewServeMux() mux.Handle("/", HelloHandler) // 미들웨어 체이닝 loggedMux := LoggingMiddleware(AuthMiddleware(mux)) // 서버 시작 http.ListenAndServe(":8080", loggedMux) } ``` 미들웨어의 장점 1. 재사용성 : 미들웨어는 여러 핸들러에서 재사용할 수 있어 코드 중복을 줄일 수 있습니다.



2. 유지보수성 : 공통 기능을 미들웨어로 분리하면 코드의 유지보수가 용이해집니다.



3. 구성 가능성 : 미들웨어를 조합하여 다양한 기능을 쉽게 구성할 수 있습니다.

결론 Go에서 HTTP 미들웨어를 만드는 것은 요청 및 응답 처리 과정에서 공통적인 기능을 추가하는 강력한 방법입니다.

미들웨어를 통해 코드의 재사용성과 유지보수성을 높일 수 있으며, 다양한 기능을 조합하여 유연한 웹 애플리케이션을 구축할 수 있습니다.