소개
Odoo XML Parse Error는 모듈 설치, 업그레이드 혹은 서버 시작 과정에서 Odoo가 XML 파일을 읽거나 검증하지 못할 때 발생합니다.
커스텀 Odoo 개발에서 자주 마주치는 오류인데, 그 이유는 Odoo가 XML을 통해 많은 핵심 요소를 정의하기 때문입니다:
- 뷰(View)
- 액션(Action)
- 메뉴(Menu)
- 보안 규칙(Security rules)
- 데이터 레코드(초기 데이터)
XML 파일에 문법 오류나 잘못된 참조가 섞여 있으면 Odoo는 처리를 중단하고 즉시 XML Parse Error를 발생시킵니다.
이 가이드는 XML 파스 오류가 왜 발생하는지, 그리고 문제를 정확히 고치는 방법을 단계별로 설명합니다.
Odoo에서 XML 파스 오류란 무엇인가?
Odoo는 모듈의 __manifest__.py 파일의 data 섹션에 등록된 XML 파일들을 로드합니다:
'data': [
'views/sale_order_view.xml',
'security/ir.model.access.csv',
]
설치나 업그레이드 과정에서 Odoo는 다음 작업을 수행합니다:
- XML 파일을 읽음
- 구조를 검증함
- 뷰 상속(View inheritance)을 적용함
- 레코드를 생성하거나 업데이트함
만약 XML 구조가 잘못되었거나 존재하지 않는 필드나 모델을 참조하면, Odoo는 파싱 오류를 발생시킵니다.
서버 로그에는 일반적으로 다음과 같은 메시지가 출력됩니다:
XML Parse Error while parsing /path/to/view.xml
Odoo XML 파스 오류의 주요 원인
1. 닫는 태그 누락 또는 잘못된 태그
잘못된 예시:
<field name="name">
닫는 태그 없이 끝남:
</field>
XML은 태그 구조가 엄격해야 합니다.
2. 뷰에서 존재하지 않는 필드 참조
뷰가 모델에 없는 필드를 참조하면:
<field name="non_existing_field"/>
Odoo는 XML 처리 중 검증 오류를 발생시킵니다.
3. 잘못된 뷰 상속 사용
뷰를 상속할 때:
<record id="view_form_inherit" model="ir.ui.view">
<field name="inherit_id" ref="sale.view_order_form"/>
참조한 뷰가 존재하지 않으면 파싱이 실패합니다.
4. 잘못된 XPath 표현식
예시:
<xpath expr="//field[@name='wrong_name']" position="after">
XPath가 부모 뷰의 어떤 요소와도 매칭되지 않으면 Odoo가 오류를 낼 수 있습니다.
5. 외부 ID(External ID) 중복
두 레코드가 동일한 id를 사용할 경우:
<record id="view_form" model="ir.ui.view">
해당 ID가 이미 존재하면 Odoo는 충돌 오류를 발생시킵니다.
6. 잘못된 XML 구조(포맷 문제)
예시:
- 루트 태그 <odoo> 누락
- 잘못된 중첩 구조
- 허용되지 않는 문자 사용
- 탭 문자를 잘못 사용함
Odoo의 XML은 엄격한 포맷 규칙을 따라야 합니다.
7. 보안 파일 설정 오류
XML에 접근 규칙을 정의할 때 다음 항목을 잘못 참조하면,
- 존재하지 않는 모델을 지정하거나,
- 정의되지 않은 그룹을 참조하는 경우,
파서가 실패합니다.
Odoo XML 파스 오류 해결 방법
1단계 – 서버 로그를 꼼꼼히 확인하세요
화면에 나오는 오류 메시지는 대개 간단한 형태입니다.
서버 로그에서 다음 항목을 찾아보세요:
XML Parse Error while parsing...
트레이스백(traceback)이 다음 정보를 알려줍니다:
- 파일 경로
- 라인 번호
- 오류 유형
2단계 – XML 문법 검증하기
문제가 의심되는 XML 파일을 열어 다음을 점검하세요:
- 열고 닫는 태그가 정확한지
- 태그의 중첩이 올바른지
- 따옴표가 빠지지 않았는지
- 문자 인코딩과 들여쓰기가 이상하지 않은지
필요하면 XML 유효성 검사 도구를 사용하세요.
3단계 – 필드 이름 확인
뷰에서 참조한 모든 필드가 해당 모델에 실제로 존재하는지 확인하세요.
개발자 모드를 활성화하면 모델 필드를 더 쉽게 확인할 수 있습니다.
4단계 – 뷰 상속 검증
inherit_id를 쓸 경우 다음을 확인하세요:
- 참조한 뷰가 실제로 있는지
- 외부 ID가 정확한지
5단계 – XPath 표현식 점검
XPath가 부모 뷰의 실제 요소를 정확히 가리키는지 확인하세요.
잘못된 XPath는 파스 오류의 흔한 원인입니다.
6단계 – 수정 후 재시작 및 모듈 업그레이드
문제를 수정한 뒤에는,
- Odoo를 재시작하고,
- 로그가 더 상세히 보이도록 커맨드라인에서 모듈을 업그레이드하세요:
./odoo-bin -u module_name -d database_name
XML 파스 오류를 예방하는 방법
- XML 파일을 깔끔하고 규칙적으로 유지하세요.
- 필드명을 참조하기 전에 반드시 존재 여부를 검증하세요.
- 불필요하게 복잡한 XPath 사용은 피하세요.
- 뷰 상속은 신중하게 테스트하세요.
- 버전 관리로 변경 이력을 추적하세요.
- 프로덕션에 배포하기 전 스테이징에서 충분히 테스트하세요.
XML 파스 오류는 흔하지만, 규율 있는 개발 관행으로 충분히 예방할 수 있습니다.
다솔로(Dasolo)의 안정적인 뷰 설계 방식
XML 파스 오류는 보통 뷰 상속의 복잡성, 필드 참조 오류 또는 모듈 구조의 불일치 같은 근본 원인을 시사합니다. 로그에서 특정 XML 라인을 가리키더라도 실제 원인은 설계나 참조의 불일치인 경우가 많습니다.
다솔로에서는 XML 관련 실패를 줄이기 위해 다음 포인트에 집중합니다:
- 명확하고 최소화된 뷰 상속 구조
- 정확한 필드 참조 관행
- 확인된 범위 내에서의 모듈 확장
- 배포 전 엄격한 검증 절차
- 스테이징 기반의 테스트 워크플로우
단순하고 잘 구조화된 뷰 아키텍처는 설치나 업그레이드 과정에서 파싱 오류 발생 가능성을 크게 낮춥니다.
결론
Odoo의 “XML Parse Error”는 문법 오류, 잘못된 필드 참조, 또는 상속 충돌 때문에 XML 파일 검증에 실패할 때 발생합니다. 흔히 모듈 설치나 업그레이드 중에 드러나지만, 근본 원인은 뷰 설계의 구조적 불일치인 경우가 많습니다.
XML 구조를 꼼꼼히 검토하고 필드 존재 여부를 확인하며 불필요한 상속을 줄이면 반복적인 파싱 실패를 예방할 수 있습니다. 뷰 아키텍처에 대한 규율 있는 접근은 안정적인 배포와 장기적인 유지보수를 보장합니다.