AI가 짠 마이그레이션 파일 리뷰하기

AI의 최적화가 불러오는 함정

AI 코딩 어시스턴트(Cursor, Copilot 등)에게 데이터베이스 스키마 변경을 요청하면, 대개 교과서적이고 직접적인 쿼리를 작성해 줍니다. 개발 환경에서는 아무 문제가 없지만, 이 코드를 그대로 Production(운영)에 푸시하는 순간 대참사가 발생할 수 있습니다.

우리는 앞서 파괴적 변경(Destructive Change)이 얼마나 위험한지, 무중단 배포를 위해 5단계 우회로가 왜 필요한지 배웠습니다. 따라서 AI가 짜준 코드가 우리의 운영 원칙을 위배하지 않는지 매의 눈으로 심사해야 합니다.

이 세 가지 항목을 하나씩 자세히 뜯어보겠습니다.

체크리스트 1: 파괴적인 명령어가 있는가?

리뷰할 때 가장 먼저 찾아야 하는 단어는 `DROP`, `RENAME`, 그리고 데이터 타입을 직접 변경하는 `ALTER ... TYPE` 구문입니다.

ALTER TABLE users RENAME COLUMN user_email TO email_address;
ALTER TABLE users ALTER COLUMN email_address TYPE VARCHAR(255);
DROP COLUMN old_legacy_field;

위 스크립트를 보고 "문법이 완벽하군" 하고 승인(Approve)한다면, 배포되는 순간 에러 폭풍을 맞이하게 됩니다.

• RENAME과 DROP: 즉시 구버전 애플리케이션의 쿼리를 고장 냅니다.
• ALTER TYPE: 데이터 타입을 변경하는 작업은 테이블 내부적으로 데이터를 재기록해야 하는 경우가 많아, 오랫동안 테이블 전체에 쓰기 잠금(Lock)을 걸 수 있습니다.

대응 방법: 이런 파괴적 쿼리를 발견했다면, AI에게 "운영 환경이므로 다운타임이 발생하면 안 돼. Expand and Contract 패턴을 써서 새로운 컬럼을 추가하는 방식으로 다시 짜줘"라고 명확히 재요청해야 합니다.

체크리스트 2: 하위 호환성을 유지하는가?

파괴적인 명령어가 없더라도 안심할 수 없습니다. 단순히 컬럼을 새로 추가(`ADD COLUMN`)하는 스크립트라도, 기존 시스템을 고장 낼 수 있는 지뢰가 숨어 있습니다.

가장 대표적인 지뢰가 바로 `NOT NULL` 제약조건과 기본값(Default) 누락입니다.

대응 방법: 추가되는 컬럼에 `NULL`이 허용되어 있는지, 혹은 앱이 데이터를 넣지 않아도 괜찮도록 `DEFAULT` 값이 안전하게 설정되어 있는지 확인하세요.

체크리스트 3: 과도한 잠금(Lock)을 유발하는가?

마이그레이션이 서비스 장애를 일으키는 또 다른 원인은 바로 성능 문제입니다. 데이터가 1,000만 건 있는 테이블에 무심코 인덱스를 생성하면, 데이터베이스는 인덱스를 굽는 몇 분(혹은 몇 시간) 동안 해당 테이블의 삽입/수정 작업을 모두 차단해 버립니다.

-- AI가 제안한 흔한 인덱스 생성 (위험!)
CREATE INDEX idx_users_email ON users(email);

이 쿼리가 실행되는 동안 사용자는 회원가입을 할 수도, 프로필을 수정할 수도 없습니다. 타임아웃 에러가 폭주하게 됩니다.

대응 방법: PostgreSQL 같은 현대적인 데이터베이스는 잠금을 최소화하며 백그라운드에서 인덱스를 생성하는 기능을 제공합니다. AI에게 "인덱스 생성 시 테이블 Lock을 걸지 않도록 CONCURRENTLY 옵션을 사용해줘"라고 지시해야 합니다.

-- 안전한 인덱스 생성 방식 (PostgreSQL 예시)
CREATE INDEX CONCURRENTLY idx_users_email ON users(email);

바이브코딩 시대의 인간의 역할

코드를 타이핑하는 일은 기계가 훨씬 빠르고 정확하게 해냅니다. 하지만 그 코드가 비즈니스 환경과 인프라의 맥락 속에서 어떤 파급 효과를 낼지 상상하고 차단하는 것은 여전히 시스템을 책임지는 사람의 몫입니다.

AI를 유능하지만 현장 경험이 부족한 주니어 개발자라고 생각해 보세요. 마이그레이션 파일의 리뷰 버튼을 누르기 전, 머릿속으로 "이 스크립트가 실행될 때, 아직 업데이트되지 않은 어제 버전의 앱이 동시에 돌고 있다면 무슨 일이 벌어질까?"라는 질문을 꼭 한 번 던져보시기 바랍니다.