🧾 엑셀 다운로드 오류(JDK 교체) 이슈 처리 기록

📌 이슈 요약

• 이슈명: 엑셀 다운로드 시 java.awt.GraphicsEnvironment$LocalGE 오류 발생
• 원인: OpenJDK11U가 headless(화면 없는 서버) 환경을 지원하지 않아 Apache POI 동작 중 오류 발생
• 해결방안: Temurin 11 (x64, headless-friendly) JDK로 교체 후 Tomcat 재기동

---

⚙️ 조치 상세 내역

① 현재 JDK 버전 확인

java -version
ps -ef | grep java
/etc/java11/bin/java ...
openjdk version "11" 2018-09-25

✅ OpenJDK11U (구버전) 사용 중 확인

② JDK 교체 필요 사실 확인

Temurin은 서버용(headless-friendly)으로 기본 설정되어 있으며
동일 환경에서 엑셀 다운로드 정상 동작 확인됨 → 교체 필요 결정

③ 서버 아키텍처 확인

uname -m
x86_64

✅ Intel/AMD 64bit 서버 환경 (x64용 JDK 필요)

④ Temurin 11 (x64) 다운로드 및 압축 해제

cd /home/project/jdk
wget https://github.com/adoptium/temurin11-binaries/releases/download/jdk-11.0.28+6/OpenJDK11U-jdk_x64_linux_hotspot_11.0.28_6.tar.gz
tar -xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.28_6.tar.gz
rm OpenJDK11U-jdk_x64_linux_hotspot_11.0.28_6.tar.gz

⑤ Temurin 설치 확인

/home/project/jdk/jdk-11.0.28+6/bin/java -version

openjdk version "11.0.28" 2025-07-17
OpenJDK Runtime Environment Temurin-11.0.28+6 (build 11.0.28+6)
OpenJDK 64-Bit Server VM Temurin-11.0.28+6 (build 11.0.28+6, mixed mode)

⑥ JAVA_HOME 경로 수정 (.profile)

# export JAVA_HOME=/etc/java11
export JAVA_HOME=/home/project/jdk/jdk-11.0.28+6

적용

source ~/.profile
echo $JAVA_HOME

✅ /home/project/jdk/jdk-11.0.28+6 로 표시되면 정상

⑦ Tomcat 재기동 후 확인

ps -ef | grep java
/home/project/jdk/jdk-11.0.28+6/bin/java ...

✅ Temurin 11 적용 완료, 엑셀 다운로드 정상 동작 확인

결론:

기존 OpenJDK11U 환경에서는 headless 모드 미지원으로 AWT 관련 오류 발생.
Temurin 11(x64, headless-friendly)로 교체 후 문제 해결 및 엑셀 다운로드 정상화.