RHEL 9.7에서 Java 25 더 이상 사용되지 않는 API 경고

Updated: 2026년 7월 3일

RHEL 9.7에서 Java 25로 업그레이드한 후, IronPDF for Java는 sun.misc.Unsafe::allocateMemory 등의 내부 Java API를 참조하는 더 이상 사용되지 않는 API 경고를 로깅합니다. PDF 생성은 계속 작동합니다; 경고는 정보 제공용이며 규제가 있는 환경에서 컴플라이언스 우려를 일으킬 수 있습니다.

경고는 IronPDF의 자체 코드가 아닌 IronPDF가 내부적으로 사용하는 gRPC/Netty 전송 라이브러리에서 발생합니다. 해당 라이브러리는 여전히 직접 메모리 접근을 위해 sun.misc.Unsafe를 호출합니다. Java 23에서는 sun.misc.Unsafe 메모리 접근 방법을 제거 대상으로 더 이상 사용하지 않음으로 선언했으며(JEP 471), Java 24 이후로 사용 시 경고가 나타납니다(JEP 498). 그래서 경고가 이제 나타나는 것입니다.

해결책

1. 경고가 비차단적인지 확인

아무것도 변경하기 전에 렌더링이 계속 성공하는지 확인하세요. 메시지는 경고이며 오류가 아니며 실행 시간 문제는 관찰되지 않았습니다. PDF 생성은 기대대로 작동하므로 소음을 제거하는 것이지 결함을 수정하는 것이 아닙니다.

2. JVM 시작 인자에 접근 플래그 추가

애플리케이션을 시작할 때 이러한 옵션을 전달하여 JVM이 전송 라이브러리가 필요한 내부 패키지를 엽니다:

--enable-native-access=ALL-UNNAMED
--sun-misc-unsafe-memory-access=allow

--enable-native-access=ALL-UNNAMED
--sun-misc-unsafe-memory-access=allow

SHELL

첫 번째 플래그는 이름 없는 모듈에 대한 네이티브 접근을 허용합니다; 두 번째는 gRPC/Netty 스택이 의존하는 sun.misc.Unsafe 메모리 API를 다시 활성화합니다. 두 플래그 모두 IronPDF의 동작을 변경하지 않습니다; 함께 사용하면 더 이상 사용되지 않는 API 경고를 억제합니다.

경고: 이 플래그는 임시 완화 조치이며, 영구적인 수정이 아닙니다. 장기적인 해결책은 번들로 제공되는 gRPC/Netty 라이브러리를 sun.misc.Unsafe에 의존하지 않는 버전으로 업데이트하는 것입니다. 미래의 Java 릴리스는 강제 규제를 더욱 강화하여 이 임시 해결책을 깨뜨릴 수 있습니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기