Airflow 설치 후 화면 에러

Airflow 마스터 클래스

작성

wsl에서 docker설치하고, airflow를 설치해서, localhost:8080으로 들어갔는데 화면에 아래와 같은 애러가 뜨면서, Dag화면이 안뜨는 상태입니다.

해결방법에 대해 말씀해주시면 감사하겠습니다.

화면 에러내용

에러내용

/home/airflow/.local/lib/python3.12/site-packages/airflow/example_dags/standard/example_external_task_parent_deferrable.py
Timestamp: 2025-07-13, 06:22:35

Traceback (most recent call last):
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/home/airflow/.local/lib/python3.12/site-packages/airflow/example_dags/standard/example_external_task_parent_deferrable.py", line 60, in <module>
    from tests_common.test_utils.watcher import watcher
ModuleNotFoundError: No module named 'tests_common'

데이터-엔지니어링 airflow

답변 2

김현진

지식공유자

안녕하세요 jooyong yang님

Airflow 설치 후 아무것도 안했는데 저렇게 뜬거죠? 로그로 봤을 때는 샘플 dag에서 문제가 생긴 것 같은데 혹시 아래 정보좀 남겨주시겠어요?

실습 환경 (wsl or mac)

설치한 airflow 버전

보고 다시 말씀드릴께요!

JooYong Yang

질문자

답변감사합니다.
정보는 아래와 같습니다.
・실습 환경 wsl
・설치한 airflow 버전: 3.0.2

확인 부탁드립니다.

김현진

지식공유자

안녕하세요

JooYong Yang님

airflow github 소스코드를 보니 에러나고 있는 저 파일은 airflow 2버전대에 존재하는 파일이고 3버전대에서는 존재하지 않는 파일입니다.

웹 화면을 보니 3버전대 잘 설치가 된 것 같은데 어떻게해서 2버전 대 파일을 인식하고 있는지 의문입니다.

혹시 설치 중 특이사항이 있으셨나요?

인프런 AI 인턴

안녕하세요, 인프런 AI 인턴입니다. JooYong Yang님.

Airflow 설치 후 발생한 화면 에러는 보통 Python 패키지의 의존성 문제로 인해 발생할 수 있습니다. 주어진 상황에서는 tests_common 모듈이 없다는 ModuleNotFoundError가 발생하고 있습니다. 이는 일반적으로 Airflow의 테스트 목적의 코드가 실제 환경에서 import 경로 문제나 패키지 누락으로 인해 발생하는 오류입니다.

해결 방법

테스트 관련 코드 비활성화:
에러 메시지에서 보이는 파일은 Airflow 예제 DAG에서 발생한 문제입니다. 이러한 예제 DAG는 종종 테스트 코드가 포함되어 있을 수 있습니다. 다음과 같은 방법으로 예제 DAG를 비활성화하는 것을 고려해보세요.
- Airflow 환경 설정 파일인 airflow.cfg를 열고 load_examples 옵션을 False로 설정하여 기본 제공되는 예제 DAG를 로드하지 않도록 설정할 수 있습니다.
```
[core]
load_examples = False
```
필요한 패키지 설치:
tests_common 모듈이 실제로 필요한 경우, 해당 모듈을 포함한 패키지가 설치되어 있는지 확인하세요. 일반적으로 이 모듈은 Airflow의 추가적인 의존성 패키지에서 제공될 수 있기 때문에 pip install 명령어로 필요한 패키지를 설치합니다.
DAG 파일 위치 변경:
문제의 시작점인 example_dags 디렉토리를 비활성화하거나 로드 경로에서 제거하여 이런 예제 파일이 실행되지 않도록 할 수 있습니다.
Docker 환경 재배포:
만약 위의 방법으로 해결되지 않는다면, 현재 설정된 Docker 환경을 재배포하는 방법도 있습니다. 이를 통해 초기 설정으로 돌아가 오류를 수정할 수 있습니다.
```
docker-compose down --volumes
docker-compose up -d
```

인프런 커뮤니티 질문&답변

Airflow 설치 후 화면 에러

해결 방법

관련 질문 참고