문제 해결

• 목록
• 스크랩

증상 및 원인

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

사전 백업 및 준비

설정 파일을 수정하기 전 오류 발생 시 복구를 위해 대상 파일의 원본을 반드시 백업하세요.

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

해결 방법

우편번호 서비스 스크립트 경로를 최신 CDN 주소로 교체해야 합니다. 환경에 따라 config.php 파일을 수정하거나 입력 폼 스킨에 직접 스크립트를 추가합니다.

방법 1: config.php 파일 수정

config.php 파일 하단에 정의된 G5_POSTCODE_JS 값을 최신 경로로 변경합니다.

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

방법 2: 스킨 파일 직접 수정

우편번호 입력 항목 아래에 직접 스크립트 코드를 삽입할 수도 있습니다.

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

적용 후 점검 및 복구

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

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