[Spring Boot] java.net.UnkownHostException 서버에서 외부 API 호출 시 에러

📌 에러 상황

• 로컬에서는 잘 호출되던 API가 서버(리눅스 환경)에서는 java.net.UnknownHostException 오류 발생
• 외부 API 도메인 이름을 서버가 인식하지 못할 때 나타나는 에러

 

📌 에러 원인

• 리눅스 서버에는 도메인 이름과 IP 주소 매핑이 필요
• hosts 파일에 도메인-아이피 매핑이 설정되지 않아서 발생

 

📌 해결 방법

1. 리눅스 서버의 hosts 파일 수정
   sudo vi /etc/hosts
   
2. 도메인과 IP 주소 추가
   123.45.67.89    test.example.com
   
3. 변경사항 저장 후 확인
   ping test.example.com