How do you register a global module exactly once in NestJS and what happens if you register it twice?

Q: How do you register a global module exactly once in NestJS and what happens if you register it twice?

// CORRECT — register once in AppModule only @Module({ imports: [ ConfigModule.forRoot({ isGlobal: true }), DatabaseModule, UsersModule, ], }) export class AppModule {} // WRONG — importing a @Global() module in a feature module too @Module({ imports: [ConfigModule.forRoot()], // registering again — causes duplicate instantiation }) export class UsersModule {} Register global modules only once in the root AppModule. Use the isGlobal: true option pattern (used by @nestjs/config) as the idiomatic approach. Add a comment in AppModule marking global module registrations so teammates know not to import them elsewhere. If a global module is accidentally imported twice, watch for duplicate provider warnings in startup logs.

Difficulty: 5/10

Global modules, Module registration, DI container behavior

Register a global module only in the root AppModule. Importing the same global module in multiple feature modules causes duplicate provider instantiation, non-deterministic resolution if factories have side effects, and in some NestJS versions silently shadows the first registration with the second.

Correct single registration vs incorrect double registration

Best practices for global module registration:

1
Register global modules only once in the root AppModule.
2
Use the isGlobal: true option pattern (used by @nestjs/config) as the idiomatic approach.
3
Add a comment in AppModule marking global module registrations so teammates know not to import them elsewhere.
4
If a global module is accidentally imported twice, watch for duplicate provider warnings in startup logs.

Scenario Questions

0-2 years experience

2-5 years experience

1While adding a new authentication guard, you placed the AuthModule (marked @Global()) in both AppModule and UsersModule. The guard now behaves inconsistently. Walk me through why that happened and how you’d fix it.

Follow-up Questions