📉 쿼리 설계 실수 예시 10가지

Elasticsearch에서 쿼리 성능과 정확도에 영향을 주는 대표적인 실수 10가지를 정리한 문서입니다.
실전 검색 엔진에서 흔히 발생하며, 사전에 방지하거나 리팩터링 시 주의해야 할 포인트입니다.

1. ❌ filter 없이 must만 사용하는 경우

• must는 relevance score 계산 포함 → 성능 저하
• 단순 조건은 반드시 filter 사용

"bool": {
  "must": [ { "term": { "status": "active" } } ] // ❌
}

✅ 개선 예시:

"bool": {
  "filter": [ { "term": { "status": "active" } } ]
}

2. ❌ from 값을 너무 크게 사용하는 경우

• from: 10000 이상은 성능 문제 + 기본 max_result_window 초과 오류
• deep pagination 비효율적

✅ 해결 방법:

• search_after 또는 scroll API 사용

3. ❌ should만 쓰고 minimum_should_match 누락

• 조건이 아무것도 안 걸리는 쿼리가 됨 (모두 일치)
• should만 있을 경우 최소 매칭 조건 설정 필요

✅ 개선 예시:

"bool": {
  "should": [
    { "match": { "title": "카카오" } },
    { "match": { "content": "카카오" } }
  ],
  "minimum_should_match": 1
}

4. ❌ wildcard 남용

• "*검색어*" 형태는 전체 인덱스를 스캔하게 되어 심각한 성능 저하 발생

✅ 대안:

• edge_ngram 또는 prefix, autocomplete index 설계 고려

5. ❌ match_all 남발

• 필터 조건 없이 전체 문서 불러오기 → 대량 트래픽 발생 위험
• 테스트 외에는 사용 자제

6. ❌ nested 필드 정렬 누락

• nested 필드를 정렬 시도하면 오류 또는 잘못된 결과

✅ 예시:

"sort": [
  {
    "comments.likes": {
      "order": "desc",
      "mode": "max",
      "nested": {
        "path": "comments"
      }
    }
  }
]

7. ❌ 정렬 필드가 text 타입

• text는 분석된 필드이므로 정렬 불가 또는 성능 저하

✅ 해결: multi-field로 keyword 필드 사용

"title": {
  "type": "text",
  "fields": {
    "raw": { "type": "keyword" }
  }
}

8. ❌ terms 쿼리에 배열이 아닌 단일 값 사용

• terms는 배열만 받음 → 단일 값 전달 시 쿼리 실패

"terms": { "status": "active" } // ❌
"terms": { "status": ["active"] } // ✅

9. ❌ 정렬 기준이 불명확하거나 중복 발생

• _score 외 정렬 필드 없으면 중복 페이지 발생 위험
• 항상 tiebreaker 필드를 함께 넣어야 함

"sort": [
  { "created_at": "desc" },
  { "_id": "asc" } // 안정적 페이징을 위해 추가
]

10. ❌ range 쿼리에서 포맷 오류

• 날짜 필드에 잘못된 포맷 전달 → 검색 실패

✅ 개선:

"range": {
  "created_at": {
    "gte": "2023-01-01T00:00:00Z",
    "lt": "2023-12-31T23:59:59Z"
  }
}

✅ 요약