Selenium UnexpectedCommandException 오류 해결하기

소개

Selenium을 사용하다 보면 'UnexpectedCommandException'이라는 오류를 만나게 될 때가 있습니다. 이 오류는 주로 드라이버가 예상하지 못한 명령을 수신했을 때 발생합니다. 코딩 에러, 드라이버 버전 불일치 또는 웹 페이지가 완전히 로드되지 않은 경우가 원인이 될 수 있습니다. 이번 블로그에서는 이 오류의 원인을 분석하고 해결 방법을 소개하겠습니다.

에러 발생 예시 코드

먼저, 'UnexpectedCommandException' 오류가 발생할 수 있는 간단한 예시 코드를 살펴보겠습니다.

from selenium import webdriver
from selenium.common.exceptions import UnexpectedCommandException
import time

# Chrome 드라이버 생성
driver = webdriver.Chrome()

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

    # 페이지가 로딩 중일 때 명령 실행
    element = driver.find_element_by_id('example_id')
    print(element.text)
except UnexpectedCommandException as e:
    print(f"예상치 못한 명령 예외 발생: {e}")
finally:
    driver.quit()

에러 해결 방법

1. 페이지가 완전히 로드될 때까지 대기하기

웹 페이지가 완전히 로드되지 않은 상태에서 Selenium이 명령을 실행하려고 하면 주로 이 문제가 발생합니다. 따라서 적절한 대기 시간을 두는 것이 중요합니다.

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

# Chrome 드라이버 생성
driver = webdriver.Chrome()
driver.get('https://www.example.com')

try:
    # 특정 요소가 로드될 때까지 대기
    element = WebDriverWait(driver, 10).until(
        EC.presence_of_element_located((By.ID, 'example_id'))
    )
    print(element.text)
except UnexpectedCommandException as e:
    print(f"예상치 못한 명령 예외 발생: {e}")
finally:
    driver.quit()

2. 드라이버 및 브라우저 버전 일치 확인

Selenium이 사용하는 웹 드라이버와 브라우저의 버전이 호환되지 않는 경우에도 이러한 오류가 발생할 수 있습니다. 따라서 브라우저 업데이트 시 드라이버도 함께 업데이트해야 합니다.

from selenium import webdriver

# Chrome 드라이버 생성
driver = webdriver.Chrome()

# 브라우저와 드라이버 버전 확인
print("브라우저 버전 정보:\n", driver.capabilities['browserVersion'])
print("드라이버 버전 정보:\n", driver.capabilities['chrome']['chromedriverVersion'])
driver.quit()

마무리

이번 포스트에서는 Selenium을 사용할 때 발생할 수 있는 'UnexpectedCommandException' 오류에 대해 알아보았습니다. 페이지 로드 후 요소에 접근하기 위한 적절한 대기 방법과 드라이버 및 브라우저 버전의 일치를 확인하는 것이 중요합니다. Selenium을 활용할 때는 항상 효율적이고 안정적인 스크립트를 작성하기 위해 주의를 기울여야 합니다.