그누보드 수정된 CSS 및 JS 파일이 브라우저에 즉시 반영되지 않는 문제 해결

• 목록
• 스크랩

그누보드 수정된 CSS 및 JS 파일이 브라우저에 즉시 반영되지 않는 문제 해결

그누보드 운영 중 CSS나 JS 파일을 수정하고 업로드했음에도 브라우저에 즉시 반영되지 않는 캐시 문제를 해결하는 방법과 버전 상수 갱신 절차를 안내합니다.

그누보드 수정된 CSS 및 JS 파일이 즉시 반영되지 않는 원인

CSS나 JS 파일을 수정하여 서버에 업로드했음에도 웹 브라우저에서 새로고침을 해도 변경된 내용이 적용되지 않는 현상은 브라우저가 이전에 로드했던 파일을 캐시(임시 저장)하고 있어 서버의 최신 파일을 불러오지 않기 때문입니다.

그누보드 5.2.3 버전 이상 CSS 및 JS 버전 상수 수정 방법

그누보드 5.2.3 버전 이상에서는 브라우저 캐시로 인해 수정된 CSS와 JS 파일이 즉시 반영되지 않는 문제를 해결하기 위해 별도의 설정 파일을 사용합니다.

1. 작업 전 백업

설정 파일을 수정하기 전, 반드시 extend/version.extend.php 파일을 로컬 PC나 서버의 안전한 위치에 복사하여 백업합니다. 문제가 발생할 경우 백업본을 복원하여 이전 상태로 되돌릴 수 있습니다.

2. 버전 상수 수정 경로 및 방법

• 설정 파일 경로: extend/version.extend.php
• 수정 방법: 파일을 열어 아래와 같이 정의된 상수 값을 임의의 숫자나 날짜 형식으로 변경합니다.

define('G5_JS_VER', '20240520');
define('G5_CSS_VER', '20240520');

버전 상수를 변경한 뒤 웹 브라우저에서 해당 페이지를 새로고침(F5)하여 변경사항이 정상적으로 반영되었는지 확인합니다.

적용 후 점검 방법

파일 수정 후 웹 브라우저에서 해당 페이지를 새로고침(F5)하여 변경사항이 정상적으로 반영되었는지 확인합니다.

버전 상수를 변경하면 방문자의 브라우저도 캐시된 파일을 버리고 서버의 최신 파일을 새로 받아오게 되어, CSS 깨짐 현상 등을 방지할 수 있습니다.

함께 보면 좋은 글

• 웹 개발 시 CSS와 JS 수정 사항이 즉시 반영되지 않을 때 해결 방법
• 그누보드 최신글 스킨에 짧은 주소가 반영되지 않을 때 해결 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드 수정된 CSS 및 JS 파일이 브라우저에 즉시 반영되지 않는 문제 해결