ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

Aufbau modularer und wiederverwendbarer Middleware für Gin- und Chi-Router

10月 09, 2025
# Misc

Grace Collins

Solutions Engineer · Leapcell

この記事はEnglish、日本語、한국어でも利用できます
Cover of "Aufbau modularer und wiederverwendbarer Middleware für Gin- und Chi-Router"

Einleitung

Beim Erstellen robuster und skalierbarer Webanwendungen mit Go spielt Middleware eine entscheidende Rolle bei der Behandlung von Querschnittsanliegen (Cross-Cutting Concerns). Stellen Sie sich Szenarien wie Benutzerauthentifizierung, Protokollierung von Anfragen, Eingabevalidierung oder Verhandlung des Inhaltstyps vor. Die Implementierung dieser Funktionalitäten direkt in jeder Handler-Funktion würde zu erheblicher Code-Duplizierung, verwickelter Logik und einem Wartungsalptraum führen. Genau hier glänzt die Leistungsfähigkeit der Middleware. Durch die Abstraktion dieser gemeinsamen Funktionalitäten in separate, austauschbare Komponenten können wir sauberere, modularere und äußerst wartbare Codebasen erreichen. Dieser Artikel konzentriert sich darauf, wie man effektiv komponierbare und wiederverwendbare Middleware für zwei der beliebtesten Web-Frameworks von Go: Gin und Chi schreibt, und befähigt Entwickler, elegante und effiziente APIs zu erstellen.

Middleware verstehen: Die Bausteine von Webanwendungen

Bevor wir uns mit den Besonderheiten von Gin und Chi befassen, wollen wir ein grundlegendes Verständnis dafür entwickeln, was Middleware ist und welche Kernkonzepte sie umgeben.

Was ist Middleware?

Im Kern ist Middleware eine Funktion oder eine Reihe von Funktionen, die HTTP-Anfragen und -Antworten verarbeiten, bevor oder nachdem die eigentliche Handler-Funktion ausgeführt wird. Sie bilden eine "Pipeline", durch die eine HTTP-Anfrage läuft, die es jeder Middleware ermöglicht, ihre spezifische Aufgabe auszuführen, die Anfrage oder Antwort zu modifizieren und dann die Kontrolle an das nächste Element in der Pipeline zu übergeben, bis schließlich der endgültige Handler erreicht wird.

Kernkonzepte

  • Anforderungs-/Antwort-Abfang: Middleware fängt den Fluss einer HTTP-Anfrage ab und ermöglicht so Vorverarbeitung (z. B. Authentifizierung) oder Nachverarbeitung (z. B. Protokollierung des Antwortstatus).
  • Chaining/Pipelining: Mehrere Middleware-Funktionen können miteinander verbunden werden, um eine Sequenz zu bilden. Jede Middleware kann entscheiden, ob sie die Anfrage an die nächste in der Kette weitergibt oder die Anfrage frühzeitig beendet (z. B. bei einem Authentifizierungsfehler).
  • Kontext: Middleware nutzt häufig den HTTP-Kontext, um Daten zu speichern und abzurufen, die über die gesamte Middleware-Kette und mit dem endgültigen Handler geteilt werden können. Dies vermeidet globale Variablen und fördert die Thread-sichere Datenfreigabe.
  • Wiederverwendbarkeit: Eine gut gestaltete Middleware sollte generisch genug sein, um ohne Änderung auf verschiedene Routen oder sogar verschiedene Anwendungen angewendet zu werden.
  • Komponierbarkeit: Die Fähigkeit, mehrere kleinere, aufgabenbezogene Middleware-Funktionen zu komplexeren Funktionalitäten zu kombinieren.

Gin- und Chi-Middleware-Signaturen

Obwohl sowohl Gin als auch Chi ihre eigenen internen APIs haben, bieten sie sehr ähnliche Muster zur Definition von Middleware.

Gin Middleware-Signatur:

In Gin hat eine Middleware-Funktion typischerweise die Signatur func(*gin.Context). Das gin.Context-Objekt enthält http.ResponseWriter und *http.Request sowie Methoden zur Verwaltung des Anfragelebenszyklus, wie Next(), Abort() und Set().

// Beispiel Gin Middleware: Logger
func LoggerMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        start := time.Now()
        c.Next() // Verarbeitet die nächste Middleware/Handler
        duration := time.Since(start)
        log.Printf("Request - Method: %s, Path: %s, Status: %d, Duration: %v",
            c.Request.Method, c.Request.URL.Path, c.Writer.Status(), duration)
    }
}

Chi Middleware-Signatur:

Chi-Middleware hält sich enger an die Standard net/http-Schnittstelle. Eine Middleware-Funktion in Chi hat typischerweise die Signatur func(http.Handler) http.Handler. Dieses "Decorator"-Muster ist sehr leistungsfähig und ermöglicht es Middleware, einen http.Handler zu umwickeln und einen neuen zurückzugeben.

// Beispiel Chi Middleware: RequestID
func RequestIDMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        reqID := r.Header.Get("X-Request-ID")
        if reqID == "" {
            reqID = uuid.New().String()
        }
        ctx := context.WithValue(r.Context(), RequestIDKey, reqID)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

// Definition eines Schlüssels für den Kontext
type ContextKey string
const RequestIDKey ContextKey = "requestID"

Beachten Sie den Unterschied: GINs Next() bewegt sich explizit zum nächsten Handler, während Chi next.ServeHTTP() den umwickelten Handler aufruft. Beide erreichen das gleiche Ziel, die Anfrageverarbeitung fortzusetzen.

Wiederverwendbare Middleware schreiben

Der Schlüssel zur Wiederverwendbarkeit liegt darin, Ihre Middleware so generisch und konfigurierbar wie möglich zu gestalten.

Parametrisierte Middleware

Anstatt Werte fest zu codieren, lassen Sie die Middleware bei der Initialisierung konfigurieren.

// Gin: Ratenbegrenzungs-Middleware
func RateLimitMiddleware(maxRequests int, window time.Duration) gin.HandlerFunc {
    // In einem echten Szenario würde dies einen ausgefeilteren Algorithmus zur Ratenbegrenzung verwenden,
    // wie z. B. einen Token-Bucket oder Leaky Bucket, und möglicherweise einen verteilten Speicher.
    // Der Einfachheit halber verwenden wir einen einfachen In-Memory-Zähler pro IP.
    ipCounters := make(map[string]int)
    lastResets := make(map[string]time.Time)
    mu := sync.Mutex{}

    return func(c *gin.Context) {
        ip := c.ClientIP()

        mu.Lock()
        defer mu.Unlock()

        if _, ok := lastResets[ip]; !ok || time.Since(lastResets[ip]) > window {
            ipCounters[ip] = 0
            lastResets[ip] = time.Now()
        }

        if ipCounters[ip] >= maxRequests {
            c.AbortWithStatusJSON(http.StatusTooManyRequests, gin.H{"error": "Too many requests"})
            return
        }

        ipCounters[ip]++
        c.Next()
    }
}

// Chi: Authentifizierungs-Middleware
func AuthMiddleware(secretKey string) func(http.Handler) http.Handler {
    return func(next http.Handler) http.Handler {
        return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
            token := r.Header.Get("Authorization")
            if token == "" || !isValidToken(token, secretKey) { // isValidToken wäre eine echte Validierungsfunktion
                http.Error(w, "Unauthorized", http.StatusUnauthorized)
                return
            }
            // Wenn das Token gültig ist, können Sie Benutzerinformationen im Kontext speichern
            ctx := context.WithValue(r.Context(), UserIDKey, "some_user_id") // Gehen Sie davon aus, dass UserIDKey definiert ist
            next.ServeHTTP(w, r.WithContext(ctx))
        })
    }
}

// Dummy isValidToken zur Demonstration
func isValidToken(token, secretKey string) bool {
    // In einer echten App, validieren Sie JWT, API-Schlüssel usw.
    return token == "Bearer mysecrettoken" && secretKey == "supersecret"
}

Middleware mit Options-Muster

Für Middleware, die mehrere optionale Parameter akzeptiert, ist das "Options-Muster" (funktionale Optionen) eine saubere Möglichkeit, Konfigurationen bereitzustellen.

// Gin: LogLevel Middleware mit Optionen
type LogLevel int

const (
    LogInfo LogLevel = iota
    LogError
)

type LoggerOptions struct {
    LogLevel LogLevel
    IncludeHeaders bool
}

type LoggerOption func(*LoggerOptions)

func WithLogLevel(level LogLevel) LoggerOption {
    return func(o *LoggerOptions) {
        o.LogLevel = level
    }
}

func WithHeaders() LoggerOption {
    return func(o *LoggerOptions) {
        o.IncludeHeaders = true
    }
}

func ConfigurableLoggerMiddleware(opts ...LoggerOption) gin.HandlerFunc {
    options := LoggerOptions{
        LogLevel: LogInfo,
        IncludeHeaders: false,
    }
    for _, opt := range opts {
        opt(&options)
    }

    return func(c *gin.Context) {
        start := time.Now()
        c.Next()
        duration := time.Since(start)

        if options.LogLevel == LogInfo {
            log.Printf("Request Info - Method: %s, Path: %s, Status: %d, Duration: %v",
                c.Request.Method, c.Request.URL.Path, c.Writer.Status(), duration)
            if options.IncludeHeaders {
                log.Println("Headers:", c.Request.Header)
            }
        } else if options.LogLevel == LogError && c.Writer.Status() >= 400 {
            log.Printf("Request Error - Method: %s, Path: %s, Status: %d, Message: %s",
                c.Request.Method, c.Request.URL.Path, c.Writer.Status(), c.Errors.ByType(gin.ErrorTypePrivate).String())
        }
    }
}

// Verwendung:
// r.Use(ConfigurableLoggerMiddleware(WithLogLevel(LogError)))
// r.Use(ConfigurableLoggerMiddleware(WithLogLevel(LogInfo), WithHeaders()))

Komponierbare Middleware erstellen

Komponierbarkeit ergibt sich oft natürlich aus der Struktur von Middleware-Funktionen. Indem jede Middleware auf eine einzige Verantwortung konzentriert wird, können Sie sie leicht kombinieren, um komplexere Verarbeitungspipelines zu erstellen.

// Gin Beispiel: Kombination mehrerer Middleware-Funktionen
func setupGinRouter() *gin.Engine {
    r := gin.New()

    // Globale Middleware, die auf alle Routen angewendet wird
    r.Use(gin.Logger()) // Integrierter Gin-Logger
    r.Use(gin.Recovery()) // Integrierter Gin-Recovery
    r.Use(RateLimitMiddleware(10, time.Minute)) // Unsere benutzerdefinierte Ratenbegrenzung

    // Spezifische Middleware auf eine Gruppe von Routen anwenden
    adminGroup := r.Group("/admin")
    adminGroup.Use(AuthMiddleware("supersecret")) // Unsere benutzerdefinierte Authentifizierung
    {
        adminGroup.GET("/dashboard", func(c *gin.Context) {
            c.JSON(http.StatusOK, gin.H{"message": "Willkommen Admin!"})
        })
    }

    r.GET("/public", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"message": "Öffentlicher Zugang"})
    })

    return r
}

// Chi Beispiel: Kombination mehrerer Middleware-Funktionen
func setupChiRouter() http.Handler {
    r := chi.NewRouter()

    // Globale Middleware, die auf alle Routen angewendet wird
    r.Use(middleware.Logger) // Integrierter Chi-Logger
    r.Use(middleware.Recoverer) // Integrierter Chi-Recoverer
    r.Use(RequestIDMiddleware) // Unsere benutzerdefinierte Request-ID

    // Spezifische Middleware auf eine Gruppe von Routen anwenden
    r.Group(func(adminRouter chi.Router) {
        adminRouter.Use(AuthMiddleware("supersecret")) // Unsere benutzerdefinierte Authentifizierung
        adminRouter.Get("/admin/dashboard", func(w http.ResponseWriter, r *http.Request) {
            w.Write([]byte("Willkommen Admin!"))
        })
    })

    r.Get("/public", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Öffentlicher Zugang"))
    })

    return r
}

In beiden Beispielen sehen Sie, wie die Use()-Methode (Gin) bzw. r.Use() und r.Group() (Chi) die einfache Komposition ermöglichen. Sie listen einfach die Middleware-Funktionen in der gewünschten Reihenfolge auf. Die Reihenfolge ist sehr wichtig, da jede Middleware die Anfrage sequentiell verarbeitet.

Praxisbeispiel: JWT-Authentifizierungs-Middleware

Lassen Sie uns eine umfassendere und wiederverwendbare JWTAuthMiddleware für beide Frameworks demonstrieren.

Gin JWT-Middleware:

package middleware

import (
    "net/http"
    "strings"
    "time"

    "github.com/dgrijalva/jwt-go"
    "github.com/gin-gonic/gin"
)

// Claims stellt die JWT-Claim-Struktur dar
type Claims struct {
    UserID string `json:"user_id"`
    jwt.StandardClaims
}

// JWTAuthMiddleware erstellt eine Gin-Middleware für die JWT-Authentifizierung.
func JWTAuthMiddleware(secretKey string) gin.HandlerFunc {
    return func(c *gin.Context) {
        // Token aus dem Authorization-Header extrahieren
        authHeader := c.GetHeader("Authorization")
        if authHeader == "" {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Authorization header required"})
            return
        }

        tokenParts := strings.Split(authHeader, " ")
        if len(tokenParts) != 2 || tokenParts[0] != "Bearer" {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid Authorization header format"})
            return
        }

        tokenString := tokenParts[1]

        // Token parsen und validieren
        token, err := jwt.ParseWithClaims(tokenString, &Claims{}, func(token *jwt.Token) (interface{}, error) {
            return []byte(secretKey), nil
        })

        if err != nil {
            if err == jwt.ErrSignatureInvalid {
                c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid token signature"})
                return
            }
            if ve, ok := err.(*jwt.ValidationError); ok {
                if ve.Errors&jwt.ValidationErrorExpired != 0 {
                    c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Token expired"})
                    return
                }
            }
            c.AbortWithStatusJSON(http.StatusForbidden, gin.H{"error": "Could not parse token"})
            return
        }

        if !token.Valid {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "Invalid token"})
            return
        }

        claims, ok := token.Claims.(*Claims)
        if !ok {
            c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "Failed to get token claims"})
            return
        }

        // Benutzer-ID im Kontext für nachfolgende Handler speichern
        c.Set("userID", claims.UserID)
        c.Next()
    }
}

Chi JWT-Middleware:

package middleware

import (
    "context"
    "net/http"
    "strings"
    "time"

    "github.com/dgrijalva/jwt-go"
)

// Claims stellt die JWT-Claim-Struktur dar
type Claims struct {
    UserID string `json:"user_id"`
    jwt.StandardClaims
}

// Kontextschlüssel zum Speichern der UserID definieren
type ContextKey string
const UserIDKey ContextKey = "userID"

// JWTAuthMiddleware erstellt eine Chi-Middleware für die JWT-Authentifizierung.
func JWTAuthMiddleware(secretKey string) func(http.Handler) http.Handler {
    return func(next http.Handler) http.Handler {
        return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
            authHeader := r.Header.Get("Authorization")
            if authHeader == "" {
                http.Error(w, "Authorization header required", http.StatusUnauthorized)
                return
            }

            tokenParts := strings.Split(authHeader, " ")
            if len(tokenParts) != 2 || tokenParts[0] != "Bearer" {
                http.Error(w, "Invalid Authorization header format", http.StatusUnauthorized)
                return
            }

            tokenString := tokenParts[1]

            token, err := jwt.ParseWithClaims(tokenString, &Claims{}, func(token *jwt.Token) (interface{}, error) {
                return []byte(secretKey), nil
            })

            if err != nil {
                if err == jwt.ErrSignatureInvalid {
                    http.Error(w, "Invalid token signature", http.StatusUnauthorized)
                    return
                }
                if ve, ok := err.(*jwt.ValidationError); ok {
                    if ve.Errors&jwt.ValidationErrorExpired != 0 {
                        http.Error(w, "Token expired", http.StatusUnauthorized)
                        return
                    }
                }
                http.Error(w, "Could not parse token", http.StatusForbidden)
                return
            }

            if !token.Valid {
                http.Error(w, "Invalid token", http.StatusUnauthorized)
                return
            }

            claims, ok := token.Claims.(*Claims)
            if !ok {
                http.Error(w, "Failed to get token claims", http.StatusInternalServerError)
                return
            }

            // Benutzer-ID im Kontext für nachfolgende Handler speichern
            ctx := context.WithValue(r.Context(), UserIDKey, claims.UserID)
            next.ServeHTTP(w, r.WithContext(ctx))
        })
    }
}

Diese Beispiele zeigen, wie ähnlich die Logik ist, aber wie die Interaktion mit dem Kontext des Frameworks und die Art und Weise, wie die Kontrolle an den nächsten Handler übergeben wird, unterschiedlich sind. Beide sind gleichermaßen leistungsfähig, um komponierbare und wiederverwendbare Authentifizierung zu erreichen.

Fazit

Das Schreiben effektiver Middleware ist grundlegend für die Erstellung skalierbarer und wartbarer Go-Webanwendungen. Durch das Verständnis der Kernkonzepte und die Nutzung der von Frameworks wie Gin und Chi bereitgestellten Muster können Entwickler modulare, wiederverwendbare und komponierbare Middleware erstellen, die Querschnittsanliegen elegant adressiert, was zu saubererem Code und effizienteren Entwicklungsworkflows führt. Nutzen Sie Middleware, um Ihre API-Entwicklung zu optimieren und robuste Dienste zu erstellen.

Share this article

HackerNews

More Posts from Leapcell

Popular Posts