Go Academy · leksjon

Kontrollert avslutning

Håndtere OS-signaler og tømme forbindelser

Leksjon 4 av 413 trinn

Kontrollert avslutning er en gratis leksjon i Go Academy på CoddyKit. Dette er leksjon 4 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Go Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hvorfor kontrollert avslutning?

Hvis du kaller os.Exit eller bare stopper serveren, forkastes alle pågående forespørsler. En kontrollert avslutning venter til aktive forespørsler er fullført før prosessen avsluttes.

http.Server.Shutdown

srv.Shutdown(ctx) slutter å godta nye forbindelser, venter på at aktive forespørsler skal bli ferdige, og returnerer deretter. Send inn en kontekst med en tidsfrist for å begrense ventetiden.

ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)

Signalhåndtering

Vent på SIGINT/SIGTERM i en goroutine, og kall Shutdown når signalet mottas:

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down...")
srv.Shutdown(ctx)

Fullstendig mønster for kontrollert avslutning

Start serveren i en goroutine, blokker på signalkanalen, og avslutt deretter serveren:

go func() {
    if err := srv.ListenAndServe(); err != http.ErrServerClosed {
        log.Fatal(err)
    }
}()

quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
srv.Shutdown(ctx)

http.ErrServerClosed

Etter at Shutdown er kalt, returnerer ListenAndServe http.ErrServerClosed. Behandle dette som en normal avslutning, ikke som en feil.

Tømme forbindelser

Shutdown venter på alle kaprede forbindelser og aktive WebSocket-forbindelser bare hvis handleren selv respekterer kontekstavbrytning. Handlere for long polling eller strømming må sjekke r.Context().Done().

Tidsavbrudd for avslutning

Angi et rimelig tidsavbrudd for avslutningen (10–30 sekunder). Hvis forespørsler fortsatt kjører etter tidsfristen, returnerer Shutdown context.DeadlineExceeded, og gjenværende forbindelser lukkes med tvang.

Rydding ved avslutning

Etter at Shutdown returnerer, lukker du databasepooler, tømmer loggbuffere og frigjør andre ressurser i riktig rekkefølge. Bruk defer eller en eksplisitt sekvensering.

srv.Shutdown(ctx)
db.Close()
logger.Sync()

Server.Close kontra Server.Shutdown

srv.Close() lukker alle forbindelser umiddelbart uten å vente. Bruk den bare når en tvungen avslutning er akseptabel, for eksempel i tester.

Kubernetes readiness-probe

Under avslutningen oppdaterer du readiness-proben slik at den returnerer 503 før du kaller Shutdown. Dette signaliserer til lastbalansereren at den skal slutte å rute nye forespørsler til poden.

Flere servere

Hvis du kjører flere servere (HTTP + gRPC + metrikk), avslutter du hver av dem samtidig med goroutiner og bruker en WaitGroup til å vente på at alle skal tømmes.

Hurtigsjekk

Hva gjør http.Server.Shutdown?

Oppsummering: Kontrollert avslutning

Viktige punkter:

  • srv.Shutdown(ctx) stopper nye forbindelser og venter på aktive forbindelser
  • Vent på SIGINT/SIGTERM med signal.Notify
  • ListenAndServe returnerer http.ErrServerClosed ved avslutning — dette er ikke en feil
  • Angi en tidsfrist for avslutningen for å unngå å vente for alltid
Gratis å komme i gang

Lær deg Go med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs
51
Leksjoner
203

Ofte stilte spørsmål

Er leksjonen «Kontrollert avslutning» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Go Academy, inkludert «Kontrollert avslutning», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «Kontrollert avslutning»?

Håndtere OS-signaler og tømme forbindelser Du øver på Go Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Go Academy?

Ingen tidligere erfaring er nødvendig. Go Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 4 av 4.

Hvor lang tid tar leksjonen «Kontrollert avslutning»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Go Academy-leksjonen?

Ja. Alle Go Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

  1. Opprette en HTTP-server
  2. Ruting og sti-parametere
  3. Middleware-mønsteret
  4. Kontrollert avslutning
← Tilbake til Go Academy