🚨 MongoDB TTL 인덱스 오작동 사례 분석! 자동 삭제가 안 되는 이유는?

 

🧨 사례 1. "TTL 인덱스를 만들었는데 데이터가 지워지지 않아요"

💬 문제 상황

db.logs.createIndex({ createdAt: 1 }, { expireAfterSeconds: 3600 })

• 인덱스는 정상적으로 생성됨
• 시간이 지나도 문서가 삭제되지 않음

🕵️ 원인 분석

✅ createdAt 필드가 Date 타입이 아님
MongoDB TTL은 필드가 ISODate, new Date() 형식이 아니면 작동하지 않음

✅ 해결 방법

// 잘못된 예
{ createdAt: "2025-06-29T10:00:00Z" }  // 문자열 ❌

// 올바른 예
{ createdAt: ISODate("2025-06-29T10:00:00Z") }  // Date 타입 ✅

🔧 TTL 인덱스는 문자열/숫자 필드에서는 절대 작동하지 않음!

🧨 사례 2. "일부 문서만 TTL 삭제가 안 됨"

💬 문제 상황

• 1시간 TTL 인덱스를 적용했는데, 일부 문서만 남아 있음

🕵️ 원인 분석

✅ createdAt 필드가 없는 문서
TTL은 해당 필드가 존재하지 않으면 대상에서 제외함

✅ 해결 방법

• 컬렉션 내 모든 문서에 TTL 기준 필드(createdAt)이 반드시 존재하도록 보장
• 또는 createdAt이 null일 경우를 감지하여 사전 처리

🧨 사례 3. "삭제 타이밍이 너무 늦어요"

💬 문제 상황

• expireAfterSeconds: 600 설정했는데
• 삭제가 15분~20분 후에 발생

🕵️ 원인 분석

✅ TTL은 실시간이 아니라, MongoDB 내부 백그라운드 스케줄러에 의해 동작
→ 기본적으로 60초 간격으로 TTL 스캔
→ 시스템 부하 또는 locking 상황이면 딜레이 발생

✅ 해결 방법

• TTL은 정확한 시간 보장을 하지 않음
• 만약 정확한 삭제 시간이 필요하면 → cron-job 또는 TTL + 상태필드 관리 조합 사용

📌 요약: TTL 인덱스가 작동하지 않는 주요 원인

원인	설명	해결책
❌ 날짜 필드가 Date 타입이 아님	문자열이면 무효	ISODate() 사용
❌ TTL 필드가 없는 문서	TTL 대상 아님	모든 문서에 필드 포함
⏱️ 스케줄러 지연	TTL은 정확한 시간이 아님	지연 감안 또는 보완 방식 적용

🔧 운영 팁: TTL 오작동 방지 체크리스트

✅ TTL 대상 필드는 반드시 Date 타입인지 확인
✅ 문서 생성 시 TTL 기준 필드를 무조건 포함
✅ 지연 허용이 가능한 데이터에만 TTL 사용
✅ TTL 인덱스 외에도 cron-job이나 soft delete 백업 전략 병행

📝 마무리

MongoDB TTL 인덱스는 강력하지만, 제약이 분명한 기능입니다.
실제 운영에서는 TTL이 자동 삭제를 보장하지 않을 수 있고,
이때는 원인 분석과 대체 전략이 반드시 필요합니다