소개
Odoo 모듈 의존성 오류는 Odoo가 모듈을 설치하거나 업그레이드하려 할 때 해당 모듈이 필요로 하는 다른 모듈이 누락되어 있거나 올바르게 선언되지 않아 진행을 멈출 때 발생합니다.
이 오류는 보통 다음 상황에서 발생합니다:
- 모듈 설치 시
- 모듈 업그레이드 시
- 데이터베이스 마이그레이션 시
- 커스텀 모듈 배포 시
의존성이 제대로 설정되어 있지 않으면 Odoo는 시스템의 불일치를 막기 위해 프로세스를 차단합니다.
이 가이드는 모듈 의존성 오류가 왜 생기는지, 그리고 이를 올바르게 고치는 방법을 단계별로 설명합니다.
Odoo에서 모듈 의존성이란 무엇인가?
모든 Odoo 모듈은 __manifest__.py 파일 안에 depends 항목을 가집니다:
{
'name': 'My Custom Module',
'depends': ['base', 'sale'],
}
의미는 다음과 같습니다:
- 해당 모듈은 base와 sale 모듈이 설치되어 있어야 합니다
- 필요하면 Odoo가 자동으로 해당 모듈들을 설치합니다
- 이 모듈은 base와 sale이 제공하는 모델과 기능을 사용합니다
이들 중 하나라도 없거나 잘못 선언되면 Odoo는 의존성 오류를 발생시킵니다.
Odoo 모듈 의존성 오류의 주요 원인
1. 필수 모듈 누락
모듈이 의존하는 다른 모듈이 설치되어 있지 않으면 설치를 진행할 수 없습니다.
예시:
'depends': ['stock']
stock 모듈이 설치되어 있지 않으면 → 설치 실패.
2. 매니페스트의 모듈 이름 오류
depends에 잘못된 모듈명을 적으면 Odoo가 해당 모듈을 찾지 못합니다.
'depends': ['sales']
실제 올바른 예시는:
'depends': ['sale']
이처럼 이름이 맞지 않으면 Odoo가 모듈을 인식하지 못하고 오류가 납니다.
3. 순환 의존성(사이클)
예를 들어:
- 모듈 A가 모듈 B에 의존하고
- 모듈 B가 다시 모듈 A에 의존하는 경우,
Odoo는 설치 순서를 결정할 수 없습니다.
순환 의존성은 설치 실패를 초래합니다.
4. 커스텀 모듈이 addons_path에 없음
의존성이 커스텀 모듈일 때 해당 모듈이 설정된 addons_path에 없으면 Odoo가 탐지하지 못합니다.
5. 모듈이 설치돼 있으나 제대로 로드되지 않음
이전 설치가 부분적으로 실패했거나 중단되면 시스템이 해당 모듈을 사용 불가로 판단할 수 있습니다.
6. 모듈 간 버전 불일치
커스텀 모듈이 다른 Odoo 버전용으로 작성되었을 경우 설치 또는 업그레이드 시 충돌이 발생할 수 있습니다.
Odoo 모듈 의존성 오류를 해결하는 방법
1단계 – 에러 메시지 확인
에러 메시지는 보통 어떤 의존성이 문제인지 알려줍니다.
예시:
예: ModuleNotFoundError: No module named 'stock'
또는 다음과 같이 나타날 수 있습니다:
Unmet dependencies: sale_management
2단계 – 매니페스트 파일 점검
__manifest__.py 파일을 열어 다음을 확인하세요:
- 정확한 모듈명 사용 여부
- 철자 오류 여부
- 후행 쉼표나 문법 오류 유무
Odoo의 공식 기술명과 대조해 이름을 확인하세요.
3단계 – 누락된 의존성 설치
다음 경로로 이동하세요:
앱(Apps) → 누락 모듈 검색 → 설치
커스텀 모듈일 경우 아래를 확인하세요:
- addons 폴더에 실제로 존재하는지
- addons_path 설정에 포함되어 있는지
- 앱 메뉴에서 보이는지
보이지 않으면 Odoo가 해당 모듈을 인식하지 못합니다.
4단계 – Odoo 서버 재시작
- 의존성 문제를 수정한 뒤에는:
- 서버를 재시작하세요
- 앱 목록을 갱신하세요
설치를 다시 시도하세요
5단계 – 순환 의존성 제거
- 순환 의존성이 발견되면 다음을 고려하세요:
- 공통 로직을 별도의 제3 모듈로 분리하세요
불필요한 교차 의존성을 제거하세요
모듈 간에는 명확한 계층 구조를 유지해야 합니다.
6단계 – addons_path 설정 확인
Odoo 설정 파일을 확인하세요:
addons_path = /path/to/odoo/addons,/path/to/custom/addons
모듈 의존성 오류를 예방하는 방법
- 필요한 모든 모듈이 이 디렉토리들에 위치해 있는지 확인하세요.
- 의존성은 항상 명시적으로 선언하세요
- 모듈 구조를 깔끔하고 모듈화되게 유지하세요
- 정확한 기술 모듈명을 사용하세요
- 스테이징 환경에서 설치를 테스트하세요
- 커스텀 모듈 간 관계를 문서화하세요
잘 설계된 모듈 아키텍처는 의존성 관련 설치 실패 대부분을 예방합니다.
다솔로(Dasolo)가 모듈 의존성을 깔끔하게 관리하는 방식
모듈 의존성 오류는 보통 모듈 계층이 불명확하거나 커스텀 컴포넌트들 사이에 숨은 교차 의존성이 존재할 때 발생합니다. 프로젝트가 커질수록 관리되지 않은 의존성은 설치나 업그레이드 실패로 빠르게 이어집니다.
다솔로에서는 의존성 충돌을 방지하기 위해 다음과 같은 원칙을 따릅니다:
- 의존성은 명확히 선언한다
- 모듈 경계를 분명히 정한다
- 모듈 간 결합을 최소화한다
- 순환 참조를 피한다
- 커스텀 컴포넌트의 구조와 관계를 문서화한다
이런 방식의 깔끔한 의존성 설계는 설치 예측성을 높이고 장기적인 유지보수를 쉽게 만듭니다.
결론
Odoo의 “모듈 의존성 오류”는 필수 모듈의 누락, 잘못된 선언, 또는 상호 충돌 때문에 설치·업그레이드가 중단되는 상황을 말합니다. 표면적으로는 미설치 의존성이 보고되지만, 근본 원인은 대개 모듈 구조의 불명확성입니다.
매니페스트를 꼼꼼히 검토하고 모듈 계층을 정비하며 배포 전에 의존성을 검증하면 반복되는 설치 충돌을 막을 수 있습니다. 규율 있는 모듈 아키텍처는 안정적이고 확장 가능한 Odoo 환경의 필수 조건입니다.