파이썬 Selenium ElementClickInterceptedException 해결 방법 총정리

🔎 ElementClickInterceptedException 이란?

Selenium을 이용해 웹 자동화를 진행하다 보면 클릭 동작을 수행하려는 순간 ElementClickInterceptedException 오류가 발생할 때가 있습니다. 이 예외는 Selenium이 지정한 요소를 클릭하려 했으나, 그 위를 다른 요소가 가로막고 있거나 화면에서 해당 요소가 보이지 않아 실제 클릭이 불가능할 때 발생합니다. 즉, 코드에는 문제가 없어 보이지만 페이지의 구조나 렌더링 방식 때문에 Selenium이 원하는 동작을 수행하지 못하는 상황이죠.

대표적으로 이런 경우가 있습니다. 페이지 상단의 고정 네비게이션 바가 버튼을 가려 클릭을 막는 경우, 팝업 광고나 로딩 오버레이가 화면을 덮는 경우, 스크롤이 충분히 내려가지 않아 요소가 보이지 않는 경우 등입니다. 이러한 특성은 실제 사용자 환경에서도 클릭이 되지 않는 것과 동일하므로 Selenium은 안전장치로 예외를 발생시키는 것입니다.

📝 발생 원인을 이해하는 것이 핵심

많은 초보 개발자들이 이 오류를 마주하면 단순히 time.sleep() 같은 대기 코드를 추가해 해결하려 합니다. 하지만 이는 근본적인 해결책이 될 수 없습니다. 오히려 테스트 속도만 느려지고 오류 재현성이 높아질 수 있습니다. 중요한 점은 왜 요소가 클릭되지 않는지를 먼저 파악하는 것입니다. 예외 로그와 함께 HTML 구조를 확인하고, 요소 위에 덮여 있는 다른 태그나 스타일 속성을 살펴야 하죠.

# ElementClickInterceptedException 기본 예시
from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()
driver.get("https://example.com")

button = driver.find_element(By.ID, "submit")
button.click()  # 요소가 가려져 있다면 예외 발생

🖱️ 스크롤 조정으로 해결하는 방법

많은 경우 ElementClickInterceptedException은 클릭하려는 요소가 뷰포트(현재 화면)에 완전히 보이지 않아 발생합니다. 사용자가 직접 스크롤을 내려야만 클릭 가능한 상황과 동일하죠. 이 문제를 해결하려면 Selenium에서 제공하는 execute_script() 기능을 활용해 원하는 요소까지 스크롤을 이동시킬 수 있습니다.

🔧 scrollIntoView 활용하기

scrollIntoView() 메서드를 사용하면 해당 요소를 자동으로 화면 안쪽으로 가져올 수 있습니다. 옵션을 지정하지 않으면 기본적으로 요소가 화면 하단에 위치하도록 이동합니다. 보다 안정적인 클릭을 위해 중앙 정렬 옵션을 활용하는 것도 좋은 방법입니다.

element = driver.find_element(By.ID, "target")
driver.execute_script("arguments[0].scrollIntoView(true);", element)
element.click()

🛠️ 오프셋을 이용한 세밀한 조정

단순히 요소를 화면에 보이게 하는 것만으로는 부족할 때가 있습니다. 예를 들어 상단 고정 메뉴바 때문에 요소가 가려지는 경우라면, scrollBy()를 이용해 약간 더 스크롤을 내리는 방식이 필요합니다.

element = driver.find_element(By.ID, "target")
driver.execute_script("arguments[0].scrollIntoView(true);", element)
driver.execute_script("window.scrollBy(0, -100);")  # 상단바 높이만큼 조정
element.click()

🚫 오버레이 요소 제거하기

ElementClickInterceptedException이 발생하는 또 다른 주요 원인은 오버레이(Overlay)입니다. 예를 들어 로그인 팝업, 광고 배너, 로딩 스피너와 같은 요소가 페이지 전면에 나타나면서 사용자가 원하는 버튼을 가리게 되죠. 이 경우 단순 스크롤로는 문제를 해결할 수 없고, 해당 오버레이를 닫거나 제거해야만 정상적으로 클릭이 가능합니다.

❌ 팝업 닫기 버튼 활용

가장 기본적인 방법은 팝업의 닫기 버튼을 찾아 클릭하는 것입니다. Selenium의 WebDriverWait와 expected_conditions를 이용해 닫기 버튼이 나타날 때까지 기다린 뒤, 이를 클릭해 오버레이를 해제합니다.

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

try:
    close_btn = WebDriverWait(driver, 5).until(
        EC.element_to_be_clickable((By.CLASS_NAME, "close"))
    )
    close_btn.click()
except:
    print("닫기 버튼이 나타나지 않았습니다.")

🧹 자바스크립트로 강제 제거

만약 닫기 버튼이 없거나 Selenium으로 클릭이 불가능한 경우라면, 자바스크립트를 사용해 해당 요소를 DOM에서 제거할 수 있습니다. 다만 이 방식은 실제 사용자 경험과는 차이가 있으므로 테스트 목적에서만 사용해야 합니다.

overlay = driver.find_element(By.ID, "overlay")
driver.execute_script("arguments[0].remove();", overlay)

🎯 요소를 화면 중앙으로 스크롤

Selenium에서 요소를 클릭할 때 가장 안정적인 방법 중 하나는 해당 요소를 화면의 중앙에 위치시키는 것입니다. 요소가 화면 아래쪽이나 위쪽에 걸쳐 있으면 고정된 헤더, 푸터, 광고 배너 등에 의해 클릭이 방해될 가능성이 크기 때문입니다. 따라서 scrollIntoView() 옵션을 적절히 사용하거나, 좌표를 계산해 중앙으로 이동시키는 방식이 자주 활용됩니다.

📌 scrollIntoView 중앙 정렬

기본적으로 scrollIntoView는 요소를 화면 하단에 위치시키지만, 매개변수 {block: “center”}를 지정하면 요소가 뷰포트의 중앙에 배치됩니다. 이렇게 하면 화면 상단이나 하단 고정 UI의 간섭을 줄일 수 있습니다.

element = driver.find_element(By.ID, "target")
driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", element)
element.click()

📌 좌표 기반 스크롤

요소의 좌표를 가져와 화면 중앙으로 스크롤하는 방법도 있습니다. Selenium의 location 속성을 이용해 요소의 좌표를 확인하고, 브라우저 창 크기를 고려해 중앙에 맞춰 이동하는 방식입니다. 이 방법은 다양한 해상도 환경에서도 안정적으로 적용할 수 있습니다.

element = driver.find_element(By.ID, "target")
location = element.location
size = driver.get_window_size()
y = location['y'] - (size['height'] // 2)
driver.execute_script(f"window.scrollTo(0, {y});")
element.click()

💡 자주 쓰이는 실전 코드 예시

지금까지 살펴본 방법들을 실제 프로젝트에서 어떻게 적용할 수 있는지 종합 예시 코드를 통해 알아보겠습니다. 아래 코드는 스크롤 이동, 오버레이 제거, 요소 중앙 정렬까지 다양한 상황에 대응할 수 있도록 구성된 실전 템플릿입니다.

📝 종합 예시 코드

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()
driver.get("https://example.com")

# 오버레이 제거 (닫기 버튼 있으면 클릭)
try:
    close_btn = WebDriverWait(driver, 5).until(
        EC.element_to_be_clickable((By.CLASS_NAME, "close"))
    )
    close_btn.click()
except:
    print("닫기 버튼이 없거나 클릭 불가")

# 클릭할 요소 찾기
element = driver.find_element(By.ID, "target")

# 요소 중앙으로 스크롤
driver.execute_script("arguments[0].scrollIntoView({block: 'center'});", element)

# 클릭 시도
try:
    element.click()
    print("클릭 성공")
except:
    print("ElementClickInterceptedException 발생")

✅ 체크리스트로 다시 정리

• 🔎예외 로그를 통해 어떤 요소가 클릭을 방해하는지 확인하기
• 🖱️scrollIntoView()와 scrollBy()로 화면 위치 조정
• 🚫팝업이나 오버레이 제거 후 다시 클릭 시도
• 🎯테스트 안정성을 위해 요소를 중앙에 위치시킨 뒤 클릭

❓ 자주 묻는 질문 (FAQ)