[Android SDK] 네이티브 앱 키·키 해시 정상 등록에도 MapAuthException 401 오류 발생 (신규 앱에서도 재현)

[FAQ] 지도/로컬 API 문의 전 꼭 읽어 주세요.

안녕하세요. 카카오맵 Android SDK를 사용하는 라이더 앱을 개발하고 있습니다.

카카오맵 실행 시 MapAuthException(401): Unauthorized 오류가 발생하여 문의드립니다.

앱 설정 및 코드 문제를 확인하기 위해 여러 가지 테스트를 진행했으나, 완전히 새로운 카카오 디벨로퍼스 앱에서도 동일한 오류가 재현되고 있습니다.

1. 개발 환경

  • 카카오맵 Android SDK: 2.15.2

  • 실제 테스트 기기: 삼성 SM-S948N

  • Android 디버그 빌드

  • 오류: MapAuthException(401): Unauthorized

2. 카카오 디벨로퍼스 앱 정보

기존 앱

  • 앱 이름: SUPERSONIC Rider DEV

  • 앱 ID: 1585876

  • Android 패키지명: com.supersonic.rider.dev

신규 테스트 앱

  • 앱 이름: Rider Map Auth Test

  • 앱 ID: 1596132

  • Android 패키지명: com.supersonic.rider.authtest

3. 지금까지 확인한 사항

  • 네이티브 앱 키와 Android 패키지명, 키 해시 등록 확인

  • SDK가 실행 중 사용하는 앱 키와 BuildConfig 키의 일치 여부 확인

  • SDK 키 해시와 앱에서 계산한 키 해시의 일치 여부 확인

  • 설치된 APK와 로컬 APK의 디버그 서명 일치 확인

  • 카카오맵 사용 설정 ON

  • 비즈월렛 연결 및 카카오맵 유료 API 사용 설정 완료

  • 기존 네이티브 앱 키와 복제 키 모두 401 오류 발생

  • 공식 예제를 참고해 별도 최소 테스트 앱을 제작했으나 동일한 401 오류 발생

  • 신규 카카오 디벨로퍼스 앱을 생성해 새로운 네이티브 앱 키를 적용했지만 동일한 401 오류 발생

  • 신규 키가 실제 테스트 앱에 반영된 것도 확인

4. 문의 사항

두 개의 서로 다른 카카오 디벨로퍼스 앱에서 동일한 401 인증 오류가 발생하고 있습니다.

다음 사항을 확인 부탁드립니다.

  1. 앱 ID 1585876과 1596132에서 카카오맵 Android SDK 인증 요청이 거부되는 정확한 사유가 무엇인가요?

  2. 해당 앱들의 카카오맵 SDK 이용 권한이나 인증 상태에 문제가 있는지 확인할 수 있을까요?

  3. 현재 설정 외에 Android SDK 인증을 위해 추가로 필요한 절차가 있는지 안내 부탁드립니다.

키 해시와 패키지명, 네이티브 앱 키를 반복해서 확인한 상태이므로, 가능하다면 서버 측 인증 기록을 바탕으로 구체적인 원인을 알려주시면 감사하겠습니다.

확인해보니 해시키가 달라서 에러가 발생하고 있습니다. 서버에 호출 된 해시키는 PXVDM*** 로 시작됩니다.

해당 키가 맞는지 및 디벨로퍼스에 등록되어 있는지 확인 부탁 드립니다.

추가로, 인증 시 서버에 어떤 값이 파라미터로 사용되는지 코드 상에 KakaoMapSdk.INSTANCE.getHashKey() 로 로그를 찍어서 확인해보실 수 있습니다.