[ORACLE]ORA-29548 오류

ORA-29548 Java system class 오류

1️⃣ 오류 개요

Oracle Database 환경에서 ORA-29548: Java system class reported: could not identify release specified in classes.bin 오류는 JAVAVM(Java Virtual Machine) 구성 요소의 손상 또는 버전 불일치 문제로 인해 발생하는 대표적인 일반오류형 케이스입니다.

발생 조건 요약:
- classes.bin 파일 손상
- JavaVM 패치 적용 중단 또는 비정상 종료
- JAVAVM 스키마 객체 일부 손상
- DB upgrade/patch 후 JAVAVM 관련 메타데이터 불일치

2️⃣ 1단계 — 문제 원인 파악

Oracle 내부 JavaVM 구성 요소의 상태를 점검하기 위해 다음과 같이 시스템 뷰/REGISTRY 상태를 확인합니다.

SQL> execute sys.dbms_registry.loaded('JAVAVM');
SQL> execute sys.dbms_registry.valid('JAVAVM');

결과가 INVALID 또는 LOADED=FALSE 로 나오면 JAVAVM 구성 요소에 손상이 발생한 것입니다.

3️⃣ 2단계 — 영향 범위 확인

ORA-29548 오류는 단순 SQL 실행 문제를 넘어 다음 요소에 영향을 줄 수 있습니다.

• Java 기반 기능(DBMS_SCHEDULER의 일부 잡)
• Oracle Text/Spatial 등 내부적으로 JVM을 사용하는 모듈
• 패치 적용 중 재시작 시 메타데이터 불일치

점검 포인트:
- JAVAVM 관련 invalid object 존재 여부 확인
- DBA_REGISTRY_COMPONENTS에서 Status 값 확인
- 최근 적용된 패치/업그레이드 내역 확인

4️⃣ 3단계 — 즉시 수행 가능한 임시 조치

패치 충돌 방지와 트리거 문제 회피를 위해 다음 설정을 임시로 조정합니다.

SQL> alter system set "_system_trig_enabled" = false scope=memory;
SQL> alter system set java_jit_enabled=false;

위 조치는 트리거 비활성화 및 JIT 비활성화를 통해 복구 과정에서 발생하는 충돌을 방지하기 위한 안전 장치입니다.

5️⃣ 4단계 — 근본 원인 제거 (JAVAVM 재설치/복구)

Java system을 재생성하는 방식으로 JAVAVM 손상 요소를 정상화합니다.

SQL> create or replace java system;

경우에 따라서는 Database 펌웨어/패치에 포함된 catjvm.sql, initjvm.sql 스크립트를 실행해야 할 수 있으므로, Oracle 홈에 포함된 공식 문서를 우선 확인하는 것이 안전합니다.

중요한 주의사항:
- RAC 구성일 경우 모든 노드에서 일관성 유지 필요
- DB가 CDB/PDB 구조라면 각 PDB별 JAVAVM 상태 확인 필수
- 패치 중단 이력이 있으면 OPatch 로그 확인 필요

7️⃣ 기본 오류 대응 4단계

1단계: 원인 파악
2단계: 영향 범위 확인
3단계: 임시 조치 적용
4단계: 근본 원인 제거(구성 요소 복구)

오류 분석 흐름도

외부 노출 확인 → 역할(기능) 비활성화 → 포트 차단 → 로그 모니터링

Oracle JVM 오류는 외부 네트워크 노출과 직접적 관계가 크지 않지만, 장애 분석 프로세스 전체 흐름에서는 동일한 보안·점검 체계를 유지하는 것이 중요합니다.

8️⃣ 사후 관리 및 예방 전략

• 패치/업그레이드 진행 시 반드시 백업 후 실행
• DBMS_REGISTRY 상태를 정기적으로 점검
• Oracle JavaVM 관련 invalid object 주기적 모니터링
• 패치 적용 중단/중단 후 재시작 이력이 없는지 확인
• redo/coredump 로그에서 Java 관련 에러 발생 여부 점검