TypeORM CLI와 NestJS DataSource 충돌

문제 상황

migration:generate 또는 migration:run 실행 시 에러가 발생해요.

CannotConnectAlreadyConnectedError: Cannot create a "default" connection
because connection to the database already established.

원인

NestJS 앱 부팅 방식의 ormconfig.ts가 문제에요.

export default NestFactory.create(AppModule).then((app) => {
  return app.get(DataSource);
});

1. NestFactory.create(AppModule) 실행
2. TypeOrmModule.forRootAsync()가 DataSource를 초기화하고 연결
3. TypeORM CLI가 반환된 DataSource로 initialize() 호출 시도
4. 이미 연결된 상태라 에러 발생

해결 방법

로컬 마이그레이션용 별도 설정 파일(ormconfig.local.ts)을 만들면 돼요.

import * as dotenv from "dotenv";
import { DataSource } from "typeorm";
import { getDatabaseDefaultOptions } from "./database";

// .env 파일 로드 (로컬 DB 확인 필수!)
dotenv.config({ path: path.resolve(process.cwd(), ".env") });

const defaultOptions = getDatabaseDefaultOptions();

// 연결 없이 DataSource만 생성 - CLI가 직접 연결함
const dataSource = new DataSource({
  ...defaultOptions,
  host: process.env.DB_HOST,
  port: Number(process.env.DB_PORT),
  database: process.env.DB_NAME,
  username: process.env.DB_USERNAME,
  password: process.env.DB_PASSWORD,
});

export default dataSource;

설정 파일 분리

파일	사용처	특징
ormconfig.ts	Docker/ECS 마이그레이션	NestJS 부팅 방식, 앱 컨텍스트 필요 시
ormconfig.local.ts	로컬 마이그레이션	독립 DataSource, CLI가 직접 연결

package.json 스크립트

{
  "migration:generate": "npm run build && typeorm migration:generate -d ./dist/src/ormconfig.local.js ...",
  "migration:run": "npm run build && typeorm migration:run -d ./dist/src/ormconfig.local.js",
  "migration:revert": "npm run build && typeorm migration:revert -d ./dist/src/ormconfig.local.js",
  "migration:run-docker": "node node_modules/typeorm/cli.js migration:run -d dist/src/ormconfig.js",
  "migration:revert-docker": "node node_modules/typeorm/cli.js migration:revert -d dist/src/ormconfig.js"
}

주의사항

환경 파일 확인은 필수에요.

• .env → 로컬 DB(안전)
• .env.development → AWS 개발 DB
• .env.production → AWS 운영 DB

실수로 잘못된 환경 파일을 사용하면 실제 DB가 변경될 수 있어요.