Go Academy · 강의

Gin 미들웨어: 인증과 로깅

Gin 미들웨어를 작성하고 등록합니다.

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

Gin 미들웨어 시그니처

Gin 미들웨어는 gin.HandlerFunc이며, 다음 처리기로 제어를 넘기려면 c.Next()를 호출하고 체인을 중지하려면 c.Abort()를 호출합니다.

func MyMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // before handler
        c.Next()
        // after handler
    }
}

전역으로 미들웨어 적용

r.Use를 사용하여 모든 라우트에 미들웨어를 적용합니다:

r := gin.New()
r.Use(gin.Logger())
r.Use(gin.Recovery())

로그 기록 미들웨어

Gin의 기본 gin.Logger()는 메서드, 경로, 상태 및 지연 시간을 기록합니다. 구조화된 로그 기록을 위해 zap 또는 slog를 사용하는 사용자 지정 미들웨어로 대체합니다:

func ZapLogger(logger *zap.Logger) gin.HandlerFunc {
    return func(c *gin.Context) {
        start := time.Now()
        c.Next()
        logger.Info("request",
            zap.String("method", c.Request.Method),
            zap.String("path", c.FullPath()),
            zap.Int("status", c.Writer.Status()),
            zap.Duration("latency", time.Since(start)),
        )
    }
}

인증 미들웨어

미들웨어에서 JWT 또는 API 키를 검증하고 유효하지 않으면 401로 중단합니다:

func AuthRequired() gin.HandlerFunc {
    return func(c *gin.Context) {
        token := c.GetHeader("Authorization")
        claims, err := validateJWT(token)
        if err != nil {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid token"})
            return
        }
        c.Set("user", claims)
        c.Next()
    }
}

Context를 통한 데이터 전달

c.Set("key", value)로 데이터를 저장하고, c.Get("key") 또는 c.MustGet과 같은 형식 지정 도우미로 처리기에서 가져옵니다:

user, _ := c.Get("user")
claims := user.(*Claims)

복구 미들웨어

gin.Recovery()는 패닉을 포착하고 500 응답을 반환합니다. 스택 추적을 기록하거나 오류 추적 서비스로 보내도록 사용자 지정할 수 있습니다:

r.Use(gin.CustomRecovery(func(c *gin.Context, recovered any) {
    log.Printf("panic: %v", recovered)
    c.AbortWithStatusJSON(500, gin.H{"error": "internal server error"})
}))

CORS 미들웨어

github.com/gin-contrib/cors로 CORS 헤더를 추가합니다:

r.Use(cors.New(cors.Config{
    AllowOrigins:     []string{"https://example.com"},
    AllowMethods:     []string{"GET", "POST", "PUT"},
    AllowHeaders:     []string{"Authorization", "Content-Type"},
    AllowCredentials: true,
}))

요청 빈도 제한 미들웨어

미들웨어 내부에서 golang.org/x/time/rate와 함께 IP별 토큰 버킷을 사용하여 요청 빈도를 제한합니다.

요청 ID 미들웨어

요청마다 고유한 요청 ID를 생성하고 이를 Context와 응답 헤더에 연결합니다:

func RequestID() gin.HandlerFunc {
    return func(c *gin.Context) {
        id := uuid.New().String()
        c.Set("requestID", id)
        c.Header("X-Request-ID", id)
        c.Next()
    }
}

그룹 수준 미들웨어

미들웨어를 전역으로 적용하는 대신 특정 그룹에 적용합니다:

admin := r.Group("/admin")
admin.Use(AuthRequired(), AdminOnly())
admin.GET("/users", listUsers)

미들웨어 실행 순서

미들웨어는 처리기 전에 등록 순서대로 실행되고, c.Next()가 반환된 후에는 역순으로 실행됩니다. 각 계층이 다음 계층을 감싸는 양파와 같다고 생각하면 됩니다.

빠른 확인

Gin 미들웨어는 요청이 처리기에 도달하지 못하도록 어떻게 중지합니까?

요약: Gin 미들웨어

핵심 내용:

HandlerFunc가 gin.HandlerFunc를 반환하도록 하고, 계속하려면 c.Next()를 호출합니다
c.Set/c.Get으로 체인을 통해 데이터를 전달합니다
c.AbortWithStatusJSON으로 체인을 중지하고 오류를 보냅니다
전역으로는 r.Use를, 그룹별로는 group.Use를 사용하여 적용합니다

자주 묻는 질문

“Gin 미들웨어: 인증과 로깅” 강의는 무료인가요?

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

“Gin 미들웨어: 인증과 로깅”에서 뭘 배우나요?

Gin 미들웨어를 작성하고 등록합니다. 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“Gin 미들웨어: 인증과 로깅” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← Go Academy(으)로 돌아가기