Ποια lifecycle hooks παρέχει το NestJS;

Question

Accepted Answer

Το NestJS παρέχει **lifecycle hooks** — μεθόδους που υλοποιείτε για να εκτελέσετε κώδικα σε συγκεκριμένες στιγμές του κύκλου ζωής της εφαρμογής ή ενός provider (αρχικοποίηση και τερματισμό). Είναι απαραίτητα για την εγκατάσταση (σύνδεση με πόρους) και τον καθαρισμό (κλείσιμο συνδέσεων με ασφάλεια).

## The main hooks

```ts
@Injectable()
export class DatabaseService
  implements OnModuleInit, OnApplicationShutdown {

async onModuleInit() {
    // runs once the host MODULE's dependencies are resolved → do INITIALIZATION
    await this.connect();         // e.g. open a database connection
  }

async onApplicationShutdown(signal: string) {
    // runs when the app is shutting down → do CLEANUP
    await this.disconnect();      // close connections, flush, release resources
  }
}
```

## The lifecycle sequence

```text
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.)
```

## A common use: a Prisma service connecting/disconnecting

```ts
@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
  }
}
```

Αυτό είναι το τυπικό μοτίβο για πόρους που χρειάζονται ρητή ρύθμιση/απόρριψη — σύνδεση στο `onModuleInit`, απελευθέρωση στο `onModuleDestroy`.

## Enabling shutdown hooks

```ts
// shutdown hooks must be enabled explicitly
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();        // ❗ required for onApplicationShutdown etc. to fire
```

Οι shutdown hooks εκτελούνται μόνο εάν καλέσετε `enableShutdownHooks()` — εύκολο να ξεχαστεί, και έτσι ο καθαρισμός δεν συμβαίνει ποτέ.

## Why graceful shutdown matters

```text
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 είναι σημαντικά για τη σωστή διαχείριση πόρων σε εφαρμογές NestJS — παρέχουν τα κατάλληλα σημεία για την εκτέλεση **αρχικοποίησης** (άνοιγμα συνδέσεων βάσης δεδομένων/Redis, φόρτωση δεδομένων, εγγραφή σε υπηρεσίες) και, κρίσιμα, **ασφαλούς καθαρισμού** κατά τον τερματισμό (κλείσιμο συνδέσεων, εκκένωση buffers, ολοκλήρωση εργασιών σε εξέλιξη).

Η κατανόησή τους είναι απαραίτητη για την αξιοπιστία παραγωγής: τα **hooks αρχικοποίησης** (`onModuleInit`, `onApplicationBootstrap`) διασφαλίζουν ότι η ρύθμιση συμβαίνει στον σωστό χρόνο μόλις οι εξαρτήσεις είναι έτοιμες, και τα **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) ενεργοποιούν την **ασφαλή διακοπή** — η οποία είναι ζωτική σημασίας σε σύγχρονες ανάπτυξη (τα containers/orchestrators στέλνουν SIGTERM συνεχώς κατά τις ανάπτυξες και τη κλιμάκωση, και χωρίς σωστό καθαρισμό διαρρέετε συνδέσεις και απορρίπτετε ενεργές αιτήσεις, καταστρέφοντας zero-downtime deployments).

Το τυπικό μοτίβο σύνδεσης στο `onModuleInit` και αποσύνδεσης στο `onModuleDestroy` (π.χ. για Prisma/υπηρεσίες βάσης δεδομένων) είναι καθημερινή γνώση NestJS, και η γνώση της λεπτής απαίτησης κλήσης του `enableShutdownHooks()` (ή τα shutdown hooks δεν εκτελούνται σιωπηρά ποτέ) είναι μια πρακτική, εύκολα παραβλεπόμενη λεπτομέρεια.

Η κατακτήσιμη γνώση των lifecycle hooks είναι μέρος της κατασκευής ισχυρών, έτοιμων για παραγωγή υπηρεσιών NestJS που χειρίζονται σωστά τους πόρους και τις αναπτύξεις.