Classpath 기반 경로 해결을 통한 RTF 환경 XSLT Import 오류 해결

Fixing XSLT Import Issues in MuleSoft (Works in Local but Fails in RTF Runtime)

sphurthi Edara2026년 5월 12일3분intermediate

AI 요약

Context

Anypoint Studio 로컬 환경과 Runtime Fabric(RTF) 간의 파일 시스템 접근 방식 차이로 인한 XSLT 로드 실패 발생. ${file::} 프로토콜 기반의 절대 경로 참조 방식이 JAR 패키징 구조인 RTF 런타임에서 파일 인식 불가 문제를 야기함.

Technical Solution

${file::} 참조 방식에서 XSLT 컴포넌트 내 직접 선언 방식으로 변경하여 파일 시스템 의존성 제거
부모 XSLT 내 자식 파일 참조 시 classpath 프로토콜을 적용하여 JAR 내부 리소스 접근 보장
src/main/resources/xslt/ 경로의 일관된 폴더 구조 설계를 통한 리소스 매핑 최적화
Mule Runtime 4.10.2 버전과 mule-xml-module 1.4.3 버전 간의 의존성 정렬을 통한 런타임 호환성 확보
Local-to-Runtime 환경 격차 해소를 위한 Classpath 기반 리소스 로딩 전략 채택

실천 포인트

1. JAR 패키징 환경 배포 시 ${file::} 대신 classpath 기반 리소스 참조 여부 확인

2. 런타임 버전과 사용 모듈의 버전 일치 여부 검토

3. 로컬 파일 시스템 경로가 아닌 클래스패스 루트 기준의 상대 경로 설계 적용

태그

#Resource Loading #MuleSoft #Runtime Fabric #XSLT #Classpath

원문 읽기