Настройка Selenium: установка WebDriver, Java, Python и IDE

Настройка Selenium: установка WebDriver, Java, Python и IDE
1 октября 2026 г.
18 мин чтения

Настройка Selenium: полное руководство по установке WebDriver, Java, Python и первого проекта

Первый запуск Selenium может напоминать сборку мебели без инструкции: нужны подходящие языковые привязки, браузер, драйвер и IDE, которые согласованы между собой. Это руководство описывает полный процесс настройки Selenium в Windows, macOS и Linux, а затем показывает, как проверить всё с помощью работающего теста. Также рассматривается масштабирование с Selenium Grid, запуск в Docker и что делать, когда автоматизации требуются изолированные профили браузера.

Что на самом деле включает настройка Selenium

Настройка Selenium: установка WebDriver, Java, Python и IDE - Что на самом деле включает настройка Selenium

Настройка Selenium: установка WebDriver, Java, Python и IDE - Что на самом деле включает настройка Selenium.

Selenium — это не один исполняемый файл, который вы устанавливаете и забываете. Это фреймворк, состоящий из нескольких движущихся частей:

  • Языковые привязки — библиотека, которую вы импортируете в Java, Python, C#, Ruby или JavaScript.
  • WebDriver — API и протокол, управляющий поведением браузера независимо от языка.
  • Драйверы браузеров — небольшие исполняемые файлы (ChromeDriver, GeckoDriver, EdgeDriver), которые переводят команды WebDriver в действия внутри конкретного браузера.
  • Браузер — Chrome, Firefox, Edge или Safari.
  • Инструмент сборки или IDE — Maven или Gradle для Java, pip и виртуальное окружение для Python, а также редактор, например IntelliJ IDEA, Eclipse или VS Code.

Поскольку каждый производитель браузера поддерживает собственный драйвер, шаги установки немного различаются в зависимости от целевого браузера. Хорошая новость: современные версии Selenium включают Selenium Manager, который в большинстве случаев автоматически определяет и загружает нужный драйвер, устраняя наиболее частую причину ошибок настройки.

Предварительные требования перед установкой

Настройка Selenium: установка WebDriver, Java, Python и IDE - Предварительные требования перед установкой

Настройка Selenium: установка WebDriver, Java, Python и IDE - Предварительные требования перед установкой.

Сначала проверьте эти пункты, чтобы не отлаживать две проблемы одновременно:

  1. Поддерживаемая ОС — Windows 10/11, свежая macOS или популярный дистрибутив Linux.
  2. Актуальный браузер — Chrome, Firefox или Edge, обновлённый до последней стабильной версии.
  3. Среда выполнения языка — Java JDK 11 или новее, либо Python 3.9 или новее.
  4. Права администратора — необходимы для настройки переменных среды и установки системных пакетов.
  5. Стабильная сеть — Selenium Manager загружает драйверы при первом запуске.

Настройка Selenium для Java

Java остаётся наиболее распространённым стеком Selenium в корпоративных QA-командах. Приведённые ниже шаги предполагают, что вы начинаете с чистой машины.

Шаг 1: Установите Java JDK

Скачайте сборку JDK (Temurin, Oracle или другого производителя) и запустите установщик. Затем убедитесь, что она есть в PATH:

java -version

Если команда не распознаётся, задайте JAVA_HOME в папку JDK и добавьте %JAVA_HOME%\bin (Windows) или $JAVA_HOME/bin (macOS/Linux) в PATH.

Шаг 2: Установите IDE

IntelliJ IDEA Community, Eclipse и VS Code отлично подходят. Выберите одну и при необходимости установите пакет расширений для Java.

Шаг 3: Установите Maven

Maven управляет зависимостями и сборкой. После установки проверьте:

mvn -version

Задайте MAVEN_HOME и добавьте его папку bin в PATH, если команда не выполняется.

Шаг 4: Создайте проект Maven

В вашей IDE создайте новый проект Maven с group ID, например com.example.selenium, и artifact ID, например selenium-automation. Затем добавьте зависимость Selenium в pom.xml:

<dependency>
  <groupId>org.seleniumhq.selenium</groupId>
  <artifactId>selenium-java</artifactId>
  <version>4.27.0</version>
</dependency>

Если Maven сообщает о неудачном дескрипторе артефакта, выполните mvn -U clean install, чтобы принудительно обновить, затем обновите проект в IDE.

Шаг 5: Напишите и запустите первый тест

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;

public class FirstTest {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.get("https://www.selenium.dev/documentation/webdriver/getting_started/");
        System.out.println(driver.getTitle());
        driver.quit();
    }
}

Если браузер открывается и заголовок выводится, ваша настройка Selenium для Java завершена.

Настройка Selenium для Python

Настройка Python быстрее, потому что pip управляет зависимостями и инструмент сборки не требуется.

Шаг 1: Создайте виртуальное окружение

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

Шаг 2: Установите Selenium

pip install selenium

Шаг 3: Запустите дымовой тест

from selenium import webdriver

with webdriver.Chrome() as driver:
    driver.get("https://www.selenium.dev/documentation/webdriver/getting_started/")
    print(driver.title)

Selenium Manager автоматически разрешает драйвер. Если вы предпочитаете ручной контроль, скачайте подходящий драйвер и передайте его путь через Service(executable_path=...).

Управление драйверами: Selenium Manager против ручной настройки

Подход Лучше всего для Компромисс
Selenium Manager Большинство проектов, быстрый старт Требуется доступ к сети при первом запуске
Ручная загрузка драйвера Изолированный CI, фиксированные версии Необходимо обновлять драйверы после обновления браузера
Библиотека WebDriverManager Java-команды, желающие явного контроля Дополнительная зависимость для поддержки

Для большинства читателей позволить Selenium Manager управлять драйверами — правильный выбор по умолчанию. Фиксируйте версии только тогда, когда ваша CI-среда не имеет доступа к интернету.

Проверка вашей настройки Selenium

Настройке можно доверять, только если вы можете доказать, что она работает. Выполните эти проверки:

  • Проверка версии — pip show selenium или просмотрите дерево зависимостей Maven.
  • Запуск браузера — откройте страницу, прочитайте заголовок, закройте браузер.
  • Безголовый режим — добавьте --headless=new (Chrome) или -headless (Firefox), чтобы подтвердить совместимость с CI.
  • Создание скриншота — сохраните PNG, чтобы проверить рендеринг и права на запись файлов.
  • Ожидания — протестируйте явное ожидание на динамическом элементе, чтобы подтвердить поведение по времени.

Распространённые ошибки настройки Selenium и их исправления

Ошибка Вероятная причина Исправление
SessionNotCreatedException Несовпадение версий драйвера и браузера Обновите браузер или позвольте Selenium Manager загрузить драйвер
WebDriverException: 'chromedriver' executable needs to be in PATH Драйвер не найден Добавьте папку драйвера в PATH или передайте executable_path
java.lang.NoClassDefFoundError Отсутствует зависимость Переимпортируйте проект Maven и выполните mvn clean install
ModuleNotFoundError: No module named 'selenium' Виртуальное окружение не активировано Активируйте venv перед запуском скрипта
ElementClickInterceptedException Оверлей или анимация Используйте явные ожидания и прокрутку до элемента

Масштабирование: Selenium Grid и Docker

Когда локальные тесты проходят, следующий шаг — параллельное выполнение. Selenium Grid распределяет тесты по нескольким машинам и браузерам через модель hub-and-node. В Selenium 4 автономный режим — простейшая точка входа:

java -jar selenium-server-4.27.0.jar standalone

Docker делает Grid воспроизводимым. Официальные образы Selenium позволяют запустить узлы Chrome, Firefox и Edge одной командой, что идеально для CI-конвейеров. Объедините Grid с фреймворком для тестирования, таким как TestNG, JUnit или pytest, чтобы запускать наборы параллельно и сократить время обратной связи.

Когда локальной настройки Selenium недостаточно

Selenium управляет браузером, но не изолирует его идентичность. Если ваша автоматизация входит в несколько аккаунтов на одной платформе — маркетплейсы, рекламные кабинеты, социальные профили — каждая сессия использует один и тот же отпечаток, если вы намеренно их не разделите. Здесь становится актуальным слой антидетект-браузера.

Инструменты вроде AdsPower создают изолированные профили браузера, каждый со своей конфигурацией Canvas, WebGL, User Agent и прокси. Вы можете управлять этими профилями с помощью Selenium или Playwright через локальный API, так что каждая автоматизированная сессия выглядит как отдельное устройство, а не повторный вход с одной машины. Для команд, выполняющих многоаккаунтные рабочие процессы, это сочетание часто практичнее, чем жонглирование десятками виртуальных машин.

Если это соответствует вашему случаю, руководство по автоматизации AdsPower и Python описывает настройку Local API с рабочим кодом, а обзор автоматизированного сбора данных объясняет, как масштабировать сбор, не вызывая защиту от ботов.

Лучшие практики для поддерживаемой настройки

  • Фиксируйте версию Selenium в pom.xml или requirements.txt, чтобы сборки были воспроизводимыми.
  • Используйте явные ожидания вместо time.sleep(), чтобы уменьшить нестабильность.
  • Отделяйте объекты страниц от логики тестов, чтобы изменения локаторов оставались в одном месте.
  • Запускайте в безголовом режиме в CI, с графическим интерфейсом локально для отладки.
  • Собирайте скриншоты и логи при сбоях; они экономят часы догадок.
  • Поддерживайте браузеры и драйверы актуальными — устаревшие пары — главная причина внезапных поломок.

Связанные материалы

Источники и дополнительное чтение

Часто задаваемые вопросы

Нужно ли устанавливать ChromeDriver вручную?

Обычно нет. Selenium 4.6 и более поздние версии включают Selenium Manager, который определяет версию вашего браузера и автоматически загружает подходящий драйвер. Ручная установка всё ещё полезна для офлайн CI-сред или когда нужна конкретная фиксированная версия.

Какой язык выбрать для настройки Selenium?

Java распространена в корпоративных QA-командах и хорошо сочетается с Maven, TestNG и Grid. Python быстрее настраивается и популярен для скриптинга, работы с данными и небольших проектов автоматизации. Оба поддерживают одни и те же функции WebDriver, поэтому выбирайте исходя из существующих навыков вашей команды.

Почему мой скрипт Selenium падает с SessionNotCreatedException?

Это почти всегда означает несовпадение версий браузера и драйвера. Обновите браузер до последней стабильной версии, удалите вручную установленный драйвер и позвольте Selenium Manager загрузить совместимый.

Можно ли запускать Selenium на сервере без дисплея?

Да. Используйте безголовый режим (--headless=new для Chrome, -headless для Firefox) или запускайте внутри контейнера с официальными Docker-образами Selenium. Безголовое выполнение — стандартная практика в CI-конвейерах.

Достаточно ли Selenium для автоматизации нескольких аккаунтов?

Selenium управляет браузером, но не изолирует отпечатки или прокси. Для многоаккаунтных рабочих процессов объедините Selenium с антидетект-браузером, который предоставляет отдельные профили, или используйте специализированный API автоматизации. См. руководство AdsPower и Python для конкретной настройки.

Заключение

Надёжная настройка Selenium сводится к четырём вещам: правильная среда выполнения языка, совместимые браузер и драйвер, инструмент сборки или виртуальное окружение и проверочный тест, который вы действительно запускаете. Начните с Selenium Manager для управления драйверами, добавьте явные ожидания на раннем этапе и переходите к Grid или Docker только когда параллельное выполнение станет реальной необходимостью. Если ваша автоматизация затрагивает несколько аккаунтов на одной платформе, добавьте изоляцию профилей до масштабирования — это гораздо проще заложить с самого начала, чем внедрять позже.

Drive revenue with AdsPower

Start free