NestJS bietet Lifecycle Hooks — Methoden, die Sie implementieren, um Code zu bestimmten Zeitpunkten im Lebenszyklus der Anwendung oder eines Providers auszuführen (Initialisierung und Herunterfahren). Sie sind wichtig für Setup (Verbindung zu Ressourcen) und Cleanup (Verbindungen ordnungsgemäß schließen).
()
, {
() {
.();
}
() {
.();
}
}
INITIALIZATION (startup):
onModuleInit() → after the module's providers are initialized
onApplicationBootstrap()→ after ALL modules are initialized (whole app ready)
SHUTDOWN (graceful termination):
onModuleDestroy() → cleanup as modules are destroyed
beforeApplicationShutdown() → before shutdown completes
onApplicationShutdown(signal) → final shutdown (signal = SIGTERM, etc.)
@Injectable()
export class PrismaService extends PrismaClient
implements OnModuleInit, OnModuleDestroy {
async onModuleInit() {
await this.$connect(); // connect on startup
}
async onModuleDestroy() {
await this.$disconnect(); // disconnect on shutdown — clean release
}
}
Dies ist das Standardmuster für Ressourcen, die ein explizites Setup/Teardown benötigen — verbinden in onModuleInit, freigeben in onModuleDestroy.
// shutdown hooks must be enabled explicitly
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks(); // ❗ required for onApplicationShutdown etc. to fire
Die Shutdown Hooks werden nur ausgeführt, wenn Sie enableShutdownHooks() aufrufen — leicht zu vergessen, dann findet Cleanup nie statt.
When the app receives SIGTERM (deploy, scale-down, container stop):
✗ Without shutdown hooks → connections left open, in-flight work dropped
✓ With shutdown hooks → close DB/Redis/queues cleanly, finish work → zero-downtime
Lifecycle Hooks sind wichtig für die korrekte Verwaltung von Ressourcen in NestJS-Anwendungen — sie bieten die richtigen Stellen, um Initialisierung (Öffnen von Datenbank-/Redis-Verbindungen, Laden von Daten, Registrierung bei Services) und, kritisch, ordnungsgemäße Cleanup beim Herunterfahren (Schließen von Verbindungen, Leeren von Puffern, Beendigung laufender Arbeiten) durchzuführen.
Das Verständnis ist für die Zuverlässigkeit in der Produktion unverzichtbar: Die Initialisierungs-Hooks (onModuleInit, onApplicationBootstrap) stellen sicher, dass Setup zum richtigen Zeitpunkt stattfindet, sobald Abhängigkeiten bereit sind, und die Shutdown Hooks (onModuleDestroy, onApplicationShutdown) ermöglichen ordnungsgemäßes Herunterfahren — was in modernen Deployments (Container/Orchestratoren senden während Deployments und Skalierungen ständig SIGTERM) wichtig ist, und ohne ordnungsgemäße Cleanup verlieren Sie Verbindungen und unterbrechen aktive Anfragen, was Zero-Downtime-Deployments bricht.
Das Standardmuster, sich in onModuleInit zu verbinden und sich in onModuleDestroy zu trennen (z. B. für Prisma-/Datenbankservices) ist alltägliches NestJS-Wissen, und zu wissen, dass es die subtile Anforderung gibt, enableShutdownHooks() aufzurufen (oder Shutdown Hooks feuern stillschweigend nie ab) ist ein praktisches, leicht zu übersehen Detail.
Die Beherrschung von Lifecycle Hooks ist Teil des Aufbaus robuster, produktionsreifer NestJS-Services, die Ressourcen und Deployments korrekt handhaben.