파이썬 Selenium 브라우저 언어 설정 방법 –lang=ko-KR intl.accept_languages 완벽 가이드
🌐 Selenium으로 크롬 브라우저 한국어 환경 설정하기 쉽고 빠른 방법 공개
웹 자동화를 하다 보면 특정 언어 환경에서 페이지를 테스트해야 할 때가 있습니다.
특히 한국어 기반 웹사이트라면 브라우저를 한국어로 실행해야 올바른 화면과 기능을 검증할 수 있죠.
하지만 기본 설정으로는 영어로 열리는 경우가 많아, 매번 수동으로 설정을 바꾸는 것은 번거로운 일이 됩니다.
이럴 때 꼭 필요한 기능이 바로 –lang=ko-KR 옵션과 intl.accept_languages 환경 설정입니다.
이 두 가지를 활용하면 Selenium으로 실행되는 브라우저를 처음부터 한국어로 지정할 수 있어, 자동화 효율이 크게 올라갑니다.
이 글에서는 파이썬 Selenium을 사용할 때 크롬 브라우저 언어를 한국어로 지정하는 방법을 구체적으로 알려드립니다.
옵션과 프리퍼런스를 적용하는 실제 코드 예시부터 각 방식의 차이점까지 쉽게 이해할 수 있도록 정리했습니다.
웹 테스트 자동화를 준비하거나 다국어 환경을 고려해야 하는 개발자에게 유용한 내용이 될 것입니다.
📋 목차
🌐 Selenium 브라우저 언어 설정의 필요성
웹 자동화 테스트를 진행하다 보면 기본 브라우저 언어가 영어로 설정되어 있어 원하는 결과와 다른 화면을 만나는 경우가 많습니다.
특히 한국어 기반의 웹사이트라면 로그인 화면, 버튼 텍스트, 알림 문구 등이 영어로 표시되면 테스트 결과가 왜곡되거나 잘못된 동작을 확인할 수 있습니다.
이 때문에 브라우저 언어를 한국어로 지정하는 과정은 자동화 시나리오에서 필수적인 단계입니다.
예를 들어, 동일한 웹 페이지라 하더라도 언어에 따라 HTML 구조나 요소 값이 다르게 표시되기도 합니다.
이런 차이는 크롤링이나 자동 입력 시 필드 매칭 오류를 발생시킬 수 있습니다.
따라서 초기에 브라우저 언어를 올바르게 설정하면 코드의 안정성과 유지보수성까지 높일 수 있습니다.
🔍 다국어 사이트 테스트에서의 활용
글로벌 서비스를 운영하는 경우 한국어뿐만 아니라 영어, 일본어, 중국어 등 다양한 언어로 웹사이트를 테스트해야 합니다.
이럴 때 Selenium 언어 설정은 큰 힘을 발휘합니다.
언어별 레이아웃 차이, 번역 누락 여부, 다국어 메시지 정상 출력 여부를 검증할 수 있어 QA 과정에서 매우 유용합니다.
- 🌐웹 페이지 텍스트가 한국어로 정상 출력되는지 확인
- 📑다국어 환경에서 동일한 테스트 코드 재사용 가능
- 🛡️언어 불일치로 발생할 수 있는 UI 오류 예방
💡 TIP: 테스트 자동화를 계획할 때는 초기부터 언어 설정을 반영해 두면 환경에 따라 다른 결과가 발생하는 문제를 크게 줄일 수 있습니다.
⚙️ –lang=ko-KR 옵션 적용 방법
Selenium에서 크롬 브라우저를 실행할 때 가장 간단히 한국어 환경을 설정하는 방법은 –lang=ko-KR 옵션을 사용하는 것입니다.
이 옵션은 크롬 실행 시 언어 환경을 지정해 주며, 실행되는 브라우저가 곧바로 한국어로 표시됩니다.
즉, 브라우저 UI와 웹사이트에서 제공하는 다국어 콘텐츠가 한국어로 로딩되는 효과를 얻을 수 있습니다.
💻 파이썬 코드 예시
아래는 --lang=ko-KR 옵션을 적용하는 간단한 코드 예시입니다.
Selenium과 ChromeOptions를 활용해 손쉽게 지정할 수 있습니다.
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_argument("--lang=ko-KR")
driver = webdriver.Chrome(options=options)
driver.get("https://www.google.com")
이 코드를 실행하면 구글 페이지가 한국어 버전으로 로드되며, 브라우저 UI 또한 한국어로 표시됩니다.
특히 언어 감지 기능이 있는 사이트에서 한국어 콘텐츠를 기본값으로 불러오는 데 유용합니다.
⚠️ 주의해야 할 점
⚠️ 주의: –lang 옵션은 브라우저의 UI 언어에 직접적인 영향을 주지만, 모든 웹사이트가 이를 인식하는 것은 아닙니다.
일부 사이트는 HTTP 헤더의 Accept-Language 값을 참고하기 때문에, 완전한 언어 변경을 원한다면 추가적인 프리퍼런스 설정이 필요합니다.
🔧 intl.accept_languages 프리퍼런스 설정
Selenium에서 언어를 지정하는 또 다른 방법은 intl.accept_languages 프리퍼런스를 설정하는 것입니다.
이 방식은 크롬 브라우저가 서버와 통신할 때 사용하는 Accept-Language 헤더 값을 변경하는 효과를 줍니다.
즉, 단순히 브라우저 UI뿐 아니라 웹사이트가 사용자 언어를 감지할 때 직접적으로 영향을 줍니다.
대부분의 웹사이트는 브라우저 요청 헤더를 기반으로 다국어 콘텐츠를 결정하기 때문에, intl.accept_languages 설정은 더욱 확실한 방법이라 할 수 있습니다.
이 방식은 다국어 웹페이지 테스트에서 특히 많이 활용됩니다.
💻 파이썬 코드 예시
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
options = Options()
options.add_experimental_option(
"prefs", {"intl.accept_languages": "ko-KR,ko"}
)
driver = webdriver.Chrome(options=options)
driver.get("https://www.google.com")
위 코드에서는 add_experimental_option을 통해 크롬의 프리퍼런스를 지정했습니다.
이 경우 브라우저는 서버에 요청할 때 “ko-KR, ko” 언어를 우선순위로 전달하게 되며, 구글과 같은 글로벌 서비스에서 자동으로 한국어 페이지가 표시됩니다.
📌 활용 포인트
- 🌐서버에서 제공하는 다국어 콘텐츠를 한국어로 자동 로딩
- 📑UI가 아닌 웹페이지 언어 자체를 제어하는 데 유리
- 🔧다국어 QA 및 크롤링 환경에서 안정적인 결과 보장
💎 핵심 포인트:
–lang 옵션이 브라우저 실행 시 즉각적인 효과를 주는 것과 달리, intl.accept_languages는 서버 응답을 제어하는 데 강력한 영향을 미칩니다.
💡 두 가지 방식의 차이와 활용 포인트
앞서 살펴본 –lang=ko-KR 옵션과 intl.accept_languages 프리퍼런스는 모두 브라우저 언어를 지정하는 방법이지만, 적용 범위와 동작 방식에는 차이가 있습니다.
이 차이를 이해하면 더 안정적이고 원하는 대로 자동화 환경을 구성할 수 있습니다.
📊 비교 표
| 구분 | –lang=ko-KR | intl.accept_languages |
|---|---|---|
| 적용 범위 | 브라우저 UI와 일부 웹페이지 | 서버 응답 기반 다국어 콘텐츠 |
| 설정 방식 | add_argument | add_experimental_option |
| 효과 범위 | 브라우저 실행 즉시 | 웹 서버 응답에 직접 영향 |
| 활용 추천 | UI 번역 상태 확인 | 다국어 콘텐츠 테스트 |
🔎 언제 어떤 방식을 써야 할까?
만약 단순히 크롬 브라우저의 메뉴나 UI가 한국어로 표시되는지 확인하고 싶다면 –lang=ko-KR 옵션만으로 충분합니다.
반대로 웹사이트가 서버 요청에 따라 다른 언어 페이지를 반환하는지 검증하고 싶다면 intl.accept_languages 설정이 필수적입니다.
💡 TIP: 실제 프로젝트에서는 두 가지 설정을 함께 적용하면 보다 안정적인 결과를 얻을 수 있습니다.
예를 들어 UI와 콘텐츠 언어가 동시에 한국어로 표시되어야 하는 상황에서는 --lang=ko-KR과 intl.accept_languages를 모두 지정하는 것이 좋습니다.
🛠️ 자주 발생하는 오류와 해결 방법
Selenium에서 브라우저 언어를 설정할 때 종종 예상과 다른 결과가 나올 수 있습니다.
이는 옵션 적용 방식이나 사이트의 언어 감지 로직 차이에서 발생하는데, 대표적인 오류 사례와 해결 방법을 정리했습니다.
⚠️ –lang 옵션이 적용되지 않는 경우
일부 사이트에서는 단순히 브라우저 실행 언어만 변경해도 언어가 바뀌지 않는 경우가 있습니다.
이는 해당 사이트가 Accept-Language 헤더를 우선적으로 참고하기 때문입니다.
이럴 때는 intl.accept_languages 프리퍼런스를 반드시 함께 설정해야 합니다.
🌐 언어가 섞여 표시되는 현상
구글이나 아마존과 같은 글로벌 사이트에서는 간혹 페이지의 일부가 영어, 일부는 한국어로 표시되는 경우가 있습니다.
이는 캐시나 쿠키에 저장된 이전 언어 설정이 영향을 미친 결과일 수 있습니다.
⚠️ 주의: Selenium 실행 시 항상 –incognito 옵션을 추가하거나, 기존 세션 데이터를 삭제한 뒤 테스트하는 것이 안전합니다.
🔧 크롬 버전 불일치 문제
Selenium은 크롬 드라이버와 브라우저 버전이 정확히 일치해야 안정적으로 동작합니다.
만약 브라우저 언어 설정이 적용되지 않거나 드라이버 실행이 실패한다면, 먼저 크롬 드라이버 버전을 확인하고 최신 버전으로 업데이트하는 것이 필요합니다.
- 🛠️–lang과 intl.accept_languages를 함께 지정
- 🧹캐시와 쿠키 초기화 또는 시크릿 모드 활용
- ⬆️크롬과 크롬 드라이버 버전을 최신으로 유지
💎 핵심 포인트:
언어가 제대로 적용되지 않는 경우 대부분은 옵션 누락, 세션 데이터, 드라이버 버전 문제로 요약됩니다. 이 세 가지를 점검하면 거의 모든 오류를 해결할 수 있습니다.
❓ 자주 묻는 질문 (FAQ)
–lang 옵션과 intl.accept_languages를 동시에 써야 하나요?
왜 일부 웹사이트에서는 언어가 바뀌지 않나요?
시크릿 모드를 꼭 써야 하나요?
파이어폭스에서도 같은 방법을 쓸 수 있나요?
언어를 여러 개 지정할 수 있나요?
언어 설정 후에도 구글이 영어로 나옵니다. 왜 그럴까요?
크롬 드라이버 버전이 다르면 언어가 안 바뀌나요?
모바일 크롬에서도 같은 방식이 적용되나요?
✅ Selenium 한국어 환경 설정 정리
파이썬 Selenium에서 크롬 브라우저를 한국어로 설정하는 방법은 크게 두 가지입니다.
먼저 –lang=ko-KR 옵션을 통해 브라우저 UI를 직접 한국어로 지정할 수 있습니다.
또 다른 방법은 intl.accept_languages 프리퍼런스를 설정하여 웹 서버 응답 언어를 제어하는 것입니다.
두 방식을 함께 적용하면 UI와 웹 콘텐츠 모두 안정적으로 한국어 환경에서 테스트할 수 있습니다.
테스트 자동화 시 언어 설정은 단순히 편의성을 넘어서, 다국어 웹사이트 검증과 크롤링 신뢰성을 확보하는 중요한 요소입니다.
특히 글로벌 서비스나 QA 환경에서는 언어별 차이가 오류로 이어질 수 있기 때문에, 초기 단계에서 올바른 설정을 습관처럼 적용하는 것이 바람직합니다.
또한 크롬 드라이버와 브라우저 버전을 항상 최신으로 유지하고, 필요시 시크릿 모드를 활용하면 언어 불일치 문제를 예방할 수 있습니다.
🏷️ 관련 태그 : Selenium, 파이썬웹자동화, 크롬브라우저, 언어설정, 웹테스트, intl.accept_languages, lang옵션, 다국어테스트, 웹크롤링, QA자동화