본문 바로가기
Python/Selenium

Selenium Error: Unable to locate element 오류 해결하기

by PySun 2025. 1. 11.
반응형

소개

Selenium을 사용하다보면 'Unable to locate element' 오류가 가끔 발생할 수 있습니다. 이 에러는 말씀 그대로 Selenium이 특정 요소를 찾을 수 없다는 경고입니다. 이 블로그 글에서는 오류가 발생하는 원인과 이를 해결하는 방법에 대해 알아보겠습니다.

에러 발생 예시 코드

먼저, 'Unable to locate element' 오류를 유발할 수 있는 간단한 예제 코드를 살펴보겠습니다.

from selenium import webdriver
from selenium.webdriver.common.by import By

# 웹드라이버 설정
driver = webdriver.Chrome()

# 특정 웹페이지 열기
driver.get('https://example.com')

# 요소 찾기 시도
element = driver.find_element(By.ID, 'non-existing-id')
print(element.text)

에러 해결 방법

1. 요소의 존재 확인

먼저, 찾고자 하는 요소가 실제로 페이지에 존재하는지를 확인하세요. 페이지 로드가 완료되지 않았거나, 해당 요소가 동적으로 생성되었을 수 있습니다.

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')

# 요소가 나타날 때까지 대기
element = WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.ID, 'expected-id')))
print(element.text)

2. 올바른 선택자 사용

선택자가 올바른지 확인하세요. CSS 선택자를 사용하거나 xPath를 사용하는 것도 고려해 보세요.

from selenium import webdriver
from selenium.webdriver.common.by import By

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

# CSS 선택자 사용하여 요소 찾기
element = driver.find_element(By.CSS_SELECTOR, '.existing-class')
print(element.text)

3. if 문으로 요소 존재 여부 확인

해당 요소가 존재하는지 여부를 확인한 후에 작업을 진행하는 것도 좋은 방법입니다.

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException

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

try:
    element = driver.find_element(By.ID, 'expected-id')
    print(element.text)
except NoSuchElementException:
    print("해당 요소를 찾을 수 없습니다.")

마무리

이 블로그 글에서는 Selenium에서 발생할 수 있는 'Unable to locate element' 오류에 대한 몇 가지 해결 방법을 살펴보았습니다. 페이지 요소의 존재 여부를 확인하고, 적절한 선택자를 사용함으로써 이러한 문제를 해결할 수 있습니다. 항상 Selenium 문서를 참고하여 사용할 수 있는 다양한 방법들을 익히는 것이 중요합니다.

반응형