그누보드5 카카오 우편번호 서비스 CDN 경로 업데이트 및 오류 해결

• 목록
• 스크랩

그누보드5 카카오 우편번호 서비스 CDN 경로 업데이트 및 오류 해결

카카오 우편번호 서비스 레거시 경로 종료로 발생한 404 에러와 우편번호 검색 불능 문제를 해결하는 구체적인 절차를 확인합니다.

카카오 우편번호 서비스 404 에러 원인

기존에 사용하던 레거시 도메인 기반의 카카오 우편번호 서비스가 종료되면서, 해당 경로로 스크립트를 불러올 때 404 Not Found 에러가 발생합니다. 이로 인해 회원 가입이나 주문서 등의 우편번호 검색 기능이 작동하지 않게 됩니다.

사전 백업 및 준비

설정 파일을 수정하기 전 오류 발생 시 복구를 위해 대상 파일의 원본을 반드시 백업하는 것을 권장합니다. 이는 수정 과정에서 발생할 수 있는 예기치 않은 시스템 오류에 대비하기 위함입니다.

백업 대상 파일

• config.php

백업 방법

• FTP나 파일 관리자를 통해 기존 config.php 파일을 다운로드하여 안전한 장소에 보관합니다.

config.php 파일 수정 방법

config.php 파일 하단에 정의된 G5POSTCODEJS 값을 최신 CDN 경로로 변경하여 사이트 전체의 우편번호 스크립트 경로를 업데이트할 수 있습니다.

적용 절차

1. 수정 작업 전 FTP나 파일 관리자를 통해 기존 config.php 파일을 다운로드하여 안전한 장소에 백업합니다.
2. config.php 파일 하단에 정의된 G5_POSTCODE_JS 값을 아래 코드로 변경합니다.

define('G5_POSTCODE_JS', '<script src="//t1.kakaocdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>');

1. 코드 수정 후 회원 가입 페이지나 주문서 페이지에서 F12 개발자 도구의 콘솔 창을 열어 404 에러가 발생하는지 확인하고, 우편번호 검색 버튼을 눌러 레이어 팝업이 정상적으로 작동하는지 테스트합니다.
2. 만약 수정 후 오류가 발생하거나 문제가 지속되면 백업해 둔 기존 config.php 파일을 다시 업로드하여 원상태로 복구할 수 있습니다.

스킨 파일 직접 수정을 통한 우편번호 스크립트 적용 방법

env(환경)에 따라 config.php 파일 수정이 어려운 경우, 우편번호 입력 폼 스킨을 직접 수정하여 최신 CDN 경로를 적용할 수 있습니다.

스킨 파일 수정 방법

우편번호 입력 항목 아래에 아래의 스크립트 코드를 직접 삽입합니다.

<script src="//t1.kakaocdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>

적용 후 점검

코드 수정 후 회원 가입 페이지나 주문서 페이지에 접속하여 F12 개발자 도구의 콘솔 창에서 404 에러가 발생하지 않는지 확인하고, 우편번호 검색 버튼을 눌러 레이어 팝업이 정상적으로 뜨는지 테스트합니다.

코드 수정 후 점검 및 복구 방법

1. 적용 후 정상 작동 점검

코드 수정 후 회원 가입 페이지나 주문서 페이지에 접속하여 아래의 방법으로 정상 작동 여부를 확인합니다.

• F12 개발자 도구 확인: F12 개발자 도구의 콘솔 창에서 404 에러가 발생하지 않는지 확인합니다.
• 레이어 팝업 테스트: 우편번호 검색 버튼을 눌러 레이어 팝업이 정상적으로 뜨는지 테스트합니다.

2. 오류 발생 시 복구 방법

만약 코드 수정 후 오류가 발생하거나 문제가 지속되면, 사전에 백업해 둔 기존 config.php 파일을 다시 업로드하여 원상태로 복구할 수 있습니다.

상황별 판단 및 행동 가이드

• 내 상황: 회원가입이나 주문서 페이지에서 우편번호 검색이 안 되고 404 에러가 뜸
  • 우선할 판단: 기존 레거시 카카오 우편번호 서비스 종료 여부 확인 및 config.php 백업
  • 다음 행동: FTP나 파일 관리자로 config.php 백업 후, 환경에 맞춰 config.php의 G5_POSTCODE_JS 값을 최신 CDN 경로로 수정하거나 스킨 파일에 스크립트 직접 삽입
• 내 상황: 코드 수정 후에도 우편번호 팝업이 뜨지 않거나 문제가 지속됨
  • 우선할 판단: F12 개발자 도구 콘솔창의 에러 확인 및 설정 파일 오류 여부 점검
  • 다음 행동: 사전에 백업해 둔 기존 config.php 파일을 다시 업로드하여 원상태로 복구

실전 FAQ

• Q. config.php 수정 후에도 여전히 404 에러가 발생하면 어떻게 해야 하나요?
  • A. F12 개발자 도구를 열어 스크립트 경로가 올바르게 수정되었는지 재확인하고, 문제가 지속될 경우 백업해 둔 기존 config.php 파일을 다시 업로드하여 원상태로 복구한 뒤 스킨 파일 직접 수정 방식을 대안으로 시도할 수 있습니다.

함께 보면 좋은 글

• 그누보드5 카카오 우편번호 서비스 CDN 경로 업데이트 및 스크립트 오류 해결 방법
• 그누커머스 우편번호 서비스 로딩 오류 해결 방법
• SQL UPDATE 문법 및 다중 필드 업데이트 활용법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드5 카카오 우편번호 서비스 CDN 경로 업데이트 및 오류 해결