TypeORM의 장단점은 무엇인가요?

Question

IT Interview Practice · Accepted Answer

**TypeORM**은 Node.js용 TypeScript 우선 ORM입니다. decorator에 기대어 클래스를 테이블에 매핑하며 **Active Record**와 **Data Mapper** 패턴을 모두 지원합니다. 가장 큰 매력은 깊은 TypeScript 통합이고, 가장 큰 위험은 쿼리 계층의 거친 부분과 고르지 못한 유지보수 이력입니다.

## 장점

- **TypeScript 네이티브.** entity가 decorator를 붙인 클래스라서 모델, 관계, 그리고 (주의를 기울이면) 쿼리까지 끝에서 끝까지 타입이 지정됩니다.
- **두 가지 패턴.** 소규모 앱에는 Active Record(`user.save()`)를, 테스트 가능하고 결합이 느슨한 코드에는 Data Mapper(`repository.save(user)`)를 사용하세요.
- **decorator 기반 스키마.** 컬럼, 관계, 인덱스, cascade를 entity에 인라인으로 선언합니다.

```ts
@Entity()
class User {
  @PrimaryGeneratedColumn() id: number;
  @Column({ unique: true }) email: string;
  @OneToMany(() => Post, (p) => p.author) posts: Post[];
}

const users = await dataSource
  .getRepository(User)
  .find({ where: { email: "a@b.com" }, relations: { posts: true } });
```

- 스키마 진화를 위한 **migration과 CLI**, 그리고 복잡한 SQL을 위한 유창한 **QueryBuilder**.
- Postgres, MySQL, SQLite, SQL Server 등에서 동작합니다.

## 단점

- **타입 안전성이 쿼리 경계에서 새어 나간다.** `find` 옵션과 QueryBuilder는 부분적으로만 타입이 지정되어, 잘못된 컬럼 이름은 컴파일 시점이 아니라 런타임에 실패하는 경우가 많습니다.
- **복잡한 쿼리가 어색해진다.** 깊은 join, 서브쿼리, 집계는 종종 당신을 원시(raw) SQL로 되돌립니다.
- **유지보수와 안정성.** 프로젝트에는 정체기와 버전 간 파괴적 변경(breaking change)이 있었고, 일부 버그는 오래 남습니다.
- **migration 마찰.** 자동 생성된 migration은 노이즈가 많아 손으로 편집해야 할 수 있습니다.
- **lazy 관계와 성능 지뢰** — 관계를 의도적으로 로드하지 않으면 N+1 쿼리를 쉽게 유발합니다.

## 적합한 경우

신규(greenfield) TypeScript 백엔드(**NestJS**와 자연스럽게 어울립니다), decorator 기반 모델을 중시하고 타입이 지정된 entity를 원하는 팀, 그리고 쿼리가 대부분 CRUD이고 가끔 QueryBuilder를 쓰는 앱.

## 왜 중요한가

ORM 선택은 모든 기능이 데이터베이스에 닿는 방식을 좌우하는 장기적 약속입니다. TypeORM의 TypeScript 우선 설계는 타입이 지정된 코드베이스에 실질적인 생산성 이득이지만, 면접관은 당신이 그 한계 — 부분적인 쿼리 타이핑, 복잡한 쿼리의 고통, 울퉁불퉁한 릴리스 이력 — 도 안다는 것을 듣고 싶어 합니다. 그래야 hype로 도입하는 대신, 그 편의성이 거친 부분을 언제 능가하는지 판단할 수 있기 때문입니다.

장점

단점

적합한 경우

왜 중요한가

관련 질문