어제 작동한 자동화 스크립트가 오늘 실패한다면 환경이 바뀌었을 수 있습니다. Chrome for Testing의 용도, ChromeDriver 버전 매칭, 별도 테스트 디렉터리와 버전 기록을 알아보고 로컬 검증에서 CI까지 문제를 확인하는 순서를 설명합니다.
Chrome for Testing은 브라우저 테스트와 자동화를 위한 Chrome 배포판입니다. 가장 직접적인 용도는 프로젝트에서 특정 브라우저 버전을 명시적으로 선택해 일반 Chrome의 자동 업데이트가 테스트 조건을 모르게 바꾸지 않도록 하는 것입니다.
사이트가 더 알아보기 어려운 브라우저가 아니며 선택자, CAPTCHA, 계정 권한 문제를 자동 해결하지도 않습니다. 먼저 환경을 재현 가능하게 만든 다음 원인이 페이지, 스크립트, 브라우저 버전 중 어디에 있는지 판단하세요.
일반 Chrome과 무엇이 다른가
공식 Chrome for Testing 문서는 자동 업데이트 없이 버전별 바이너리를 제공하는 테스트 전용 배포판으로 설명합니다. 일상용 브라우저는 지속적인 업데이트가 중요하지만 테스트 환경은 매번 정확히 어떤 버전을 썼는지 알아야 합니다.
따라서 일상적인 탐색과 자동화 테스트를 분리하세요. 버전을 고정하려고 주 브라우저의 보안 업데이트를 끄거나 오래된 테스트 브라우저로 일상의 신뢰할 수 없는 콘텐츠를 처리하지 마세요.
| 필요 | 더 적합한 방법 |
|---|---|
| 일상적인 탐색과 업무 | 계속 유지 관리되고 업데이트되는 일반 브라우저 사용 |
| 특정 버전에서 페이지 문제 재현 | 명확한 버전의 테스트 브라우저 선택 |
| 업그레이드 전후 동작 비교 | 이전 버전을 보관하고 새 버전의 독립 테스트 생성 |
| CI와 개발 PC 결과가 다름 | 브라우저, 드라이버, 의존성, 실행 조건을 함께 확인 |
도구가 브라우저를 시작하는 방식부터 확인하기
프로젝트는 Selenium과 ChromeDriver로 실행하거나, 다른 프레임워크가 자체 브라우저 패키지를 관리하거나, 이미 열린 디버깅 엔드포인트에 연결할 수 있습니다. 실제 사용하는 경로부터 확인하세요.
설정의 실행 파일 경로, 드라이버 출처, 캐시 디렉터리를 확인합니다. 시스템 기본 chrome의 버전을 조회했다고 테스트도 같은 파일을 쓴다는 뜻은 아닙니다. 일반 Chrome, 프레임워크가 받은 브라우저, 수동으로 압축을 푼 테스트 버전이 함께 있을 수 있습니다.
프레임워크가 브라우저를 관리한다면 해당 버전의 공식 문서를 읽은 뒤 CfT를 수동 지정할지 정하세요. 시작 경로가 불분명한 채 여러 사본을 설치하면 조사만 어려워집니다.
다운로드할 때 버전·플랫폼·출처 기록하기
공식 문서의 링크로 사용 가능한 버전 목록을 열고 운영체제와 아키텍처에 맞는 패키지를 고릅니다. 일반 설치를 덮어쓰지 말고 프로젝트에서 정한 테스트 도구 디렉터리에 둡니다.
ChromeDriver가 필요하면 공식 버전 선택 안내에 따라 호환 드라이버를 고릅니다. 공식 목록과 JSON 엔드포인트로 배포된 조합을 확인하며 외부 다운로드 사이트의 파일명으로 호환성을 추측하지 마세요.
최소한 전체 버전 번호, 운영체제와 아키텍처, 다운로드 URL, 브라우저 경로, 드라이버 버전, 업그레이드를 담당하는 프로젝트 설정을 보관합니다. 고정된 회귀 기준에는 구체적인 버전을 지정하고 매번 바뀌는 ‘최신 안정 버전’을 조회하지 않습니다.
최소 테스트 환경 만들기
테스트 브라우저를 먼저 독립 실행한 뒤 전체 업무 스크립트에 연결합니다. Windows 압축 파일의 경로는 플랫폼 패키지에 따라 다르며 다음은 압축을 푼 실행 파일의 버전만 확인하는 예입니다.
& '.\chrome-win64\chrome.exe' --version
경로가 없다면 파일 부재를 사이트 차단으로 해석하지 말고 압축 해제 위치와 다운로드 플랫폼을 확인하세요. 이후 프레임워크에 실제 경로를 명시하고 테스트용 데이터 디렉터리를 따로 사용합니다.
자신의 테스트 페이지에서 제목과 고정 요소 하나를 확인한 다음 스크린샷이나 다른 검증을 추가하세요. 실제 고객 계정, 결제, 많은 외부 의존성을 포함한 전체 흐름부터 실행하지 마세요.
실제로 무엇이 실행됐는지 로그로 알 수 있게 하기
매 실행마다 최소한 브라우저, 드라이버, 프레임워크의 전체 버전과 운영체제, 테스트 진입점을 기록합니다. 스크린샷을 저장한다면 창 크기, 확대율, 언어, 시간대 등 관련 조건도 남깁니다.
레이아웃 문제에서는 글꼴, 헤드리스와 창 모드, 네트워크 조건, 테스트 데이터도 확인합니다. 버전 고정은 일부 변수만 통제하므로 로컬과 CI의 글꼴이 다르면 스크린샷도 다를 수 있습니다.
실패 로그는 브라우저 시작 실패, 드라이버 핸드셰이크 실패, 페이지 로드 실패, 검증 실패를 구별해야 합니다. 모두 ‘자동화 실패’라고 쓰면 다음 조사 방향을 잃게 됩니다.
흔한 실패는 이 순서로 확인하기
브라우저가 시작되지 않음: 파일 권한, 운영체제 아키텍처, 실행 의존성, 다른 프로세스의 데이터 디렉터리 점유를 확인하세요. 출처 불명 시작 인수를 바로 추가하지 말고 원래 오류를 보관합니다.
지원하지 않는 버전 오류: 프레임워크가 실제 쓰는 브라우저·드라이버 경로와 전체 버전을 확인하세요. PATH의 드라이버를 업데이트해도 프레임워크 캐시의 버전은 바뀌지 않을 수 있습니다.
페이지는 열리지만 요소를 못 찾음: 선택자를 의심하기 전에 페이지 상태와 로그인·오류·권한 페이지로의 이동을 확인하세요. 고정 대기 시간을 늘리면 증상만 가릴 수 있으며 페이지가 달라진 이유는 설명하지 못합니다.
CI에서만 실패: 버전, 의존성, 글꼴, 창 조건, 네트워크 접근을 비교하고 같은 입력으로 재현하세요. CI 오류라는 이유만으로 브라우저를 바꿔야 하는 것은 아닙니다.
재현성을 유지하며 업그레이드하기
새 브라우저·드라이버 조합을 독립 브랜치나 테스트 작업에 도입합니다. 작은 스모크 테스트 후 업무와 관련된 회귀 테스트를 실행합니다. 두 변경을 함께 기록하고 되돌릴 이전 설정을 보관하세요.
결과가 달라지면 같은 입력의 로그와 이미지를 보관하고 예상된 호환성 변화, 페이지 결함, 환경 설정 중 원인을 좁힙니다. 실패할 때마다 무조건 이전 버전으로 돌아가지 말고 검증 후 기본 테스트 기준을 갱신합니다.
브라우저 환경 관리 도구가 필요한 경우
Chrome for Testing은 테스트 브라우저 버전의 가용성과 재현성을 해결합니다. 팀이 여러 고객의 허가된 세션, 프록시, 구성원 권한까지 관리해야 한다면 별도의 환경 관리 흐름으로 자원을 정리할 수 있습니다.
PurpleMark에서는 업무별 브라우저 환경을 만들고 Local API로 필요한 환경을 자체 도구에 연결하며 사용한 환경과 실제 실행 조건을 로그에 남길 수 있습니다. 이 방식은 테스트 목표에 따라 선택해야 하며 환경 관리와 버전 테스트를 같은 기능으로 봐서는 안 됩니다.
작은 웹사이트의 회귀 테스트라면 버전, 경로, 입력을 명확히 하는 것만으로 충분할 때가 많습니다. 계정, 네트워크, 협업이 실제 유지 비용을 높일 때 작업 흐름을 확장하세요. 목표는 언제나 테스트가 어떤 조건에서 실행됐는지 알고 실패 후 다시 확인할 수 있게 하는 것입니다.


