[Spring]이동 화면(페이지)에서 이미지 로드 실패 문제 해결(feat.<img> 태그 src 경로 설정)

서론

 

Spring 사이드 프로젝트를 진행하던 중 기본 홈 화면에서는 이미지가 잘 보였었는데 다른 화면으로 이동하자 이미지가 나오지 않는 문제가 발생했습니다. 홈 화면에서 잘 사용하던 이미지를 동적으로 로드하는 자바스크립트 코드가 다른 화면에서는 동작하지 않자 당황스러웠습니다. 문제의 원인은 이미지 경로 설정 때문이었습니다. 오늘은 제가 겪었던 문제에 대해 해결하는 방법을 적절한 예시와 함께 포스팅하려 합니다.

 

[개발 환경]

Spring 4.3

Tomcat 8

Open JDK 8

Chrome

 

본론

 

예를 들어 개발 웹페이지 메인 화면인 홈 화면의 url을 아래와 같다고 가정하겠습니다.

 

https://localhost:8080/devwebserver/

 

저는 이동할 화면에서 아래와 같이 이미지 객체를 생성하여 이미지 속성 src를 설정해주었습니다.

 

[문제의 JavaScript]

 

var object_img = document.createElement('img');
object_img.setAttribute('src', '/resources/images/'+ data[i].image);

 

 

그리고 홈 화면에서 url을 /move/imageview로 요청하여 imageview.jsp라는 화면으로 이동했더니 data[i]. image에 test.png라는 이미지 파일 이름값이 제대로 있음에도 불구하고 이미지가 나타나지 않았습니다. 그래서 Chrome 개발자 도구를 이용하여 문제의 화면과 정상 작동하는 화면의 img태그 src 속성 값을 비교해보니 다음과 같았습니다.

 

[이미지가 로드되지 않는 화면의 img태그 src 속성값]

 

https://localhost:8080/devwebserver/move/imageview/resources/images/test.png

 

[정상적으로 이미지가 로드되는 홈 화면의 img태그 src 속성 값]

 

https://localhost:8080/devwebserver/resources/images/test.png

 

이 둘을 비교해보고 /move/imageview 가 URL에 추가된 것이 문제라 판단했습니다. 위 자바스크립트와 같이 속성을 설정해주면 상대 경로(현재 화면의 URL)로 설정됨으로 인해 이미지가 제대로 나오지 않는 것이 원인이었습니다. 따라서 아래와 같이 항시 웹 애플리케이션의 ROOT url을 반환해주는 ${pageContext.request.contextPath}를 이용하여 문제를 해결했습니다.

 

[문제 해결 JavaScript]

 

var object_img = document.createElement('img');
object_img.setAttribute('src', '${pageContext.request.contextPath}/resources/images/'+data[i].image);

 

변경 후의 url은 아래와 같습니다.

 

https://localhost:8080/devwebserver/resources/images/test.png

 

결론

 

앞으로 이미지와 같이 리소스에 관한 경로를 설정하다 문제가 발생하면 의도대로 경로가 설정했는지 먼저 확인해야겠습니다! 구현된 자세한 소스는 아래 링크에서 확인하실 수 있습니다.

 

https://github.com/GoldSwan/PictureRepository

GitHub - GoldSwan/PictureRepository: Web Side Project with Spring