【5분으로 완료】Selenium×Python 환경 구축｜pytest＋webdriver-manager로 막히지 않는 방법

Selenium × Python 환경 구축을 초보자도 5분 만에 동작 확인까지 할 수 있도록 해설합니다.

👉 이 글의 코드를 그대로 복사해서 붙여넣으면 5분 만에 테스트가 동작합니다.

「ChromeDriver 버전이 맞지 않는다」「환경 구축에서 막힌다」——그런 고민을 해결합니다.

이 글에서는 Selenium・webdriver-manager・pytest를 사용한 실무 구성으로 에러 없이 최단 시간에 테스트를 동작시키는 방법을 해설합니다.

👉 Playwright와의 차이：Selenium은 WebDriver 경유로 브라우저를 조작하는 성숙한 기법으로 Playwright보다 구인・프로젝트 수가 압도적으로 많습니다.

Selenium 환경 구축에서 자주 있는 실패는 「ChromeDriver 버전이 맞지 않는다」「PATH가 통하지 않는다」의 두 가지입니다. 이 글에서는 webdriver-manager를 사용하여 버전 관리를 자동화하므로 막히지 않고 진행할 수 있습니다.

Selenium × Python 환경 구축의 전체 흐름

먼저 전체 흐름을 파악하고 나서 진행합시다.

STEP 1：Pythonのバージョン확인（Selenium Python 환경 구축의 전제）

먼저 Python이 설치되어 있는지 확인합니다.

python --version
# 또는
python3 --version

출력 예시：

Python 3.11.5

STEP 2：가상 환경（venv）의 생성과 활성화【Python 환경 구축】

가상 환경을 사용하면 프로젝트마다 패키지를 분리할 수 있습니다. 실무에서는 반드시 사용합시다.

가상 환경 생성

# 프로젝트 폴더 생성
mkdir selenium-project
cd selenium-project

# 가상 환경 생성
python -m venv venv

가상 환경 활성화

활성화되면 프롬프트 앞에 (venv)가 표시됩니다.

(venv) $ 

STEP 3：Selenium・webdriver-manager・pytest 설치 방법（Selenium Python 설치）

Selenium 4계열에서는 webdriver-manager를 사용하면 ChromeDriver 버전 관리가 자동화됩니다. 수동 다운로드는 불필요합니다.

pip install selenium webdriver-manager pytest

설치 확인：

pip list | grep -E "selenium|webdriver|pytest"

# 출력 예시
pytest             7.4.0
selenium           4.18.1
webdriver-manager  4.0.1

STEP 4：프로젝트 구성 작성법（pytest 구성）

실무에서 사용하기 쉬운 폴더 구성을 처음부터 정비해 둡니다.

selenium-project/
├── venv/                  # 가상 환경（Git에는 포함하지 않음）
├── tests/
│   ├── conftest.py        # fixture 정의
│   └── test_sample.py     # 테스트 파일
├── requirements.txt       # 의존 패키지 목록
└── pytest.ini            # pytest 설정

pytest.ini 작성

[pytest]
testpaths = tests
addopts = -v

STEP 5：Selenium WebDriver 설정（conftest.py）

WebDriver의 초기화・종료 처리를 conftest.py의 fixture에 집약하는 것이 실무의 베스트 프랙티스입니다.

# tests/conftest.py
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

@pytest.fixture(scope="function")
def driver():
    """Chrome WebDriver를 실행・종료하는 fixture"""
    options = webdriver.ChromeOptions()
    # options.add_argument("--headless")  # 처음에는 OFF 권장（화면을 보며 확인 가능）
    # CI/CD 환경에서는 위 줄을 ON으로 한다
    options.add_argument("--no-sandbox")            # Linux/CI 환경용（로컬에서는 불필요）
    options.add_argument("--disable-dev-shm-usage") # Linux/CI 환경용（로컬에서는 불필요）
    options.add_argument("--window-size=1920,1080")

    service = Service(ChromeDriverManager().install())
    driver = webdriver.Chrome(service=service, options=options)

    yield driver  # 테스트 실행

    driver.quit()  # 테스트 종료 후 브라우저를 닫는다

STEP 6：동작 확인 테스트 작성 방법과 실행 방법（pytest）

동작 확인에는 example.com을 사용합니다. Google은 지역에 따라 CAPTCHA나 리다이렉트가 발생할 수 있어 환경 구축 초기 확인에는 example.com이 가장 안정적입니다.

# tests/test_sample.py
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

def test_example_title(driver):
    """example.com의 title이 올바르게 취득되는지 확인"""
    driver.get("https://example.com")
    assert "Example Domain" in driver.title

def test_example_heading(driver):
    """heading이 표시될 때까지 대기하여 확인（실무 수준의 작성법）"""
    driver.get("https://example.com")
    # WebDriverWait：요소가 표시될 때까지 최대 10초 대기（실무 필수）
    # visibility_of_element_located = DOM에 있고 화면에 표시되어 있는 것을 확인
    heading = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.TAG_NAME, "h1"))
    )
    assert heading.is_displayed()

테스트 실행

pytest

실행 결과 샘플

========================== test session starts ==========================
platform darwin -- Python 3.11.5, pytest-7.4.0, selenium-4.18.1
collected 2 items

tests/test_sample.py::test_example_title    PASSED  [ 50%]
tests/test_sample.py::test_example_heading  PASSED  [100%]

========================== 2 passed in 3.21s ===========================

⚠️ 자주 있는 에러와 해결책

# 해결책：webdriver-manager를 사용하면 자동 해결
# 캐시가 오래된 경우는 삭제하고 재설치
pip install --upgrade webdriver-manager

# 해결책：가상 환경을 활성화하고 나서 재설치
source venv/bin/activate  # Mac/Linux
venv\Scripts\activate     # Windows
pip install selenium webdriver-manager

# NG
def check_example(driver):  # test_ 가 없다

# OK
def test_example_title(driver):  # test_ 가 필요

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

# 최대 10초 대기하여 요소가 표시될 때까지 기다린다
element = WebDriverWait(driver, 10).until(
    EC.visibility_of_element_located((By.TAG_NAME, "h1"))
)

Selenium과 Playwright의 사용 구분이란？

어느 쪽을 선택할지 망설이는 분을 위해 정리합니다.

FAQ

이 글의 방법대로 진행하면 환경 구축에서 막히는 일은 없습니다.

📋 이 글의 정리

2개의 테스트가 PASSED가 되는 것을 확인하면 환경 구축 완료입니다. 이후에는 테스트 케이스를 추가하면서 로그인 폼 유효성 검증 테스트・Page Object Model 패턴의 구현으로 나아가세요.