이 매뉴얼은 카카오 로그인 세팅 과정에서 자주 발생하는 에러 4가지의 원인과 해결 방법을 안내합니다.
에러 코드별 증상을 확인하고, 해당 에러의 해결 절차를 순서대로 따라 진행하면 카카오 로그인 오류를 해소할 수 있습니다.
이 매뉴얼을 완료하면 KOE205, 심사 반려, KOE006, ID 충돌 오류가 해결되고 카카오 로그인이 정상 작동하는 상태가 됩니다.
1. 준비물 #
☐ 카카오 디벨로퍼 계정 접속 가능 (developers.kakao.com)
☐ 카카오 로그인 세팅 매뉴얼을 통해 앱 생성 및 기본 설정 완료
☐ 사이트의 회원가입 페이지 URL 확인 (예: https://내도메인/register)
☐ 사이트의 개인정보처리방침 페이지 URL 확인 (예: https://내도메인/개인정보-처리방침)
2. 전체 진행 흐름 요약 #
[에러 1] KOE205 — 잘못된 요청
Step 1. 워드프레스와 카카오 디벨로퍼 동의항목 비교 및 일치시키기
[에러 2] 개인정보 동의항목 심사 반려
Step 2. 반려 사유 확인 후 3곳의 수집 항목 일치시키고 재신청
[에러 3] KOE006 — 앱 관리자 설정 오류
Step 3. Redirect URI 등록 여부 확인 및 정확한 주소 등록
[에러 4] 로그인 오류 — 기존 플러그인 ID 충돌
Step 4. 기존 카카오 사용자 데이터 삭제 및 재가입 안내
3. KOE205 — 잘못된 요청 #
Step 1. 동의항목 불일치 확인 및 수정
KOE205는 워드프레스 사이트에서 요청하는 동의 항목과 카카오 디벨로퍼에 설정된 동의 항목이 일치하지 않을 때 발생합니다. 양쪽 설정을 비교하여 정확히 동일하게 맞춥니다.
📂 경로: 카카오 디벨로퍼 → [앱 선택] → 카카오 로그인 → 동의항목 [바로 접속하기]
1. 카카오 디벨로퍼 접속 후 해당 앱 클릭
2. 카카오 로그인 → 동의항목 메뉴 이동
3. 현재 설정된 동의 항목 확인
4. 워드프레스 카카오 설정에서 체크한 항목(이메일·이름·전화번호)과 동일하게 맞춤
5. 불필요한 항목 비활성화 후 변경사항 저장 클릭
⚠️ 워드프레스 카카오 설정의 동의 항목과 카카오 디벨로퍼의 동의 항목이 정확히 일치해야 합니다. 한쪽에만 있고 다른 쪽에 없으면 KOE205 에러가 계속 발생합니다.
⚠️ 페이지 슬러그(URL 뒷부분) 주소는 영어로 작성합니다. 한글인 경우 리디렉션 주소가 정상 작동하지 않을 수 있습니다.
4. 개인정보 동의항목 심사 반려 #
Step 2. 반려 사유 확인 및 3곳 수집 항목 일치 후 재신청
심사 반려는 회원가입 페이지에서 실제로 수집하는 정보와 카카오 로그인 동의항목에서 신청한 정보가 서로 일치하지 않을 때 발생합니다. 아래 3곳의 수집 항목을 모두 동일하게 맞춘 후 재신청합니다.
반려 사유를 먼저 확인합니다.
| 항목 | 내용 |
|---|---|
| 신청 내역 | 필수 항목: 이름, 카카오계정(전화번호) |
| 반려 사유 | 회원가입 시 수집하는 항목과 심사 신청 항목이 일치하지 않음 |
| 요구 조치 | 회원가입 조건과 일치하도록 (이름, 전화번호) 항목을 변경 |
반려 사유 확인 후 아래 절차로 수집 항목을 수정하고 재신청합니다.
📂 경로: 카카오 디벨로퍼 → [앱 선택] → 카카오 로그인 → 동의항목 [바로 접속하기]
1. 사이트 회원가입 페이지(https://내도메인/register)에서 실제 수집하는 필수 항목 확인
2. 개인정보처리방침 페이지(https://내도메인/개인정보-처리방침)에 기재된 수집 항목 확인
3. 카카오 디벨로퍼 → 카카오 로그인 → 동의항목에서 위 내용과 동일하게 설정
4. 필수 항목을 이름, 전화번호로 변경
5. 변경사항 저장 후 심사 재신청 클릭
💡 TIP: 심사 승인을 위해 ① 회원가입 페이지의 입력 필드, ② 개인정보처리방침의 수집 항목 기재 내용, ③ 카카오 디벨로퍼 동의항목 설정, 이 3곳의 수집 항목이 반드시 모두 동일해야 합니다.
5. KOE006 — 앱 관리자 설정 오류 #
Step 3. Redirect URI 등록 및 주소 일치 확인
KOE006은 카카오 디벨로퍼에 등록된 Redirect URI와 실제 사이트에서 사용하는 URI가 일치하지 않을 때 발생합니다. Redirect URI는 카카오 로그인 인증 완료 후 사용자를 되돌려 보낼 사이트 주소로, 대소문자·https·끝 슬래시까지 정확히 일치해야 합니다.
📂 경로: 카카오 디벨로퍼 → [앱 선택] → 카카오 로그인 → Redirect URI [바로 접속하기]
1. 카카오 디벨로퍼 접속 후 해당 앱 클릭
2. 앱 → 플랫폼 키 → Default Rest API Key 확인
3. 사이트의 콜백 주소(https://내도메인/callback)가 정확히 등록되어 있는지 확인
4. 미등록 시 → Redirect URI 추가 클릭 후 주소 입력 → 저장 클릭
5. 이미 등록되어 있는데 오류 발생 시 → 등록된 URI와 사이트 주소의 대소문자·https·끝 슬래시 일치 여부 재확인
💡 TIP: KOE006 에러 화면에 “사용한 Redirect URI”가 표시됩니다. 이 주소를 그대로 복사하여 카카오 디벨로퍼 Redirect URI에 등록하면 가장 확실합니다.
⚠️ Redirect URI는 대소문자, https:// 포함 여부, 끝 슬래시(/) 유무까지 정확히 일치해야 합니다. 한 글자라도 다르면 KOE006 에러가 발생합니다.
6. 로그인 오류 — 기존 플러그인 ID 충돌 #
Step 4. 기존 카카오 사용자 데이터 삭제 및 재가입 안내
이전에 사용했던 카카오 로그인 플러그인과 현재 테라카카오 플러그인이 카카오 ID를 받는 방식이 달라 기존 사용자 데이터가 충돌을 일으킵니다. 기존 플러그인으로 생성된 사용자를 삭제하고 테라카카오 방식으로 재가입하도록 안내합니다.
📂 경로: 대시보드 → 사용자
1. 사용자 목록에서 기존 카카오 로그인으로 생성된 사용자 확인 (사용자명이 kakao로 시작)
2. 해당 사용자 삭제 클릭
3. 해당 사용자에게 카카오 로그인으로 다시 가입하도록 안내
💡 TIP: 테라카카오 플러그인 적용 전에 기존 카카오 로그인 플러그인을 비활성화하고 관련 사용자 데이터를 미리 정리해 두면 이 충돌 문제를 예방할 수 있습니다.
⚠️ 기존 사용자 삭제 시 해당 사용자의 주문 내역, 게시글 등 연결된 데이터도 함께 삭제될 수 있습니다. 중요한 데이터가 있는 경우 삭제 전 반드시 백업합니다.
7. 완료 체크 #
☐ 카카오 로그인 버튼 클릭 시 KOE205 에러 없이 동의 화면이 표시됨
☐ 개인정보 동의항목 심사가 승인 완료됨
☐ KOE006 에러 없이 카카오 로그인 후 사이트로 정상 리디렉션됨
☐ 기존 카카오 사용자 삭제 후 테라카카오 방식으로 재가입이 정상 완료됨
☐ 카카오 로그인 완료 후 워드프레스 사용자 목록에 신규 계정이 정상 생성됨