Android
2026-4-2
android 카카오 로그인 kakao login error 해결 - Android keyHash validation failed.
코드 문제가 아니라 카카오 개발자 콘솔 설정 문제입니다.

Android keyHash validation failed. 에러는 코드 문제가 아니라 카카오 개발자 콘솔 설정 문제입니다.
원인
Android keyHash validation failed = 카카오 앱 콘솔에 등록된 키 해시와 실제 앱의 키 해시가 불일치
해결 방법
1. 현재 앱의 키 해시 확인
MainActivity.kt 또는 MainActivity.java에 실제 기기/에뮬레이터에서 키 해시 로그를 확인하는 코드를 추가해줍니다. (확인 후에는 지워도 돼요)
import android.content.pm.PackageManager
import android.util.Base64
import android.util.Log
import java.security.MessageDigest
override fun onCreate(savedInstanceState: Bundle?) {
// 생략
try {
val info = packageManager.getPackageInfo(packageName, PackageManager.GET_SIGNATURES)
for (signature in info.signatures) {
val md = MessageDigest.getInstance("SHA")
md.update(signature.toByteArray())
Log.d("KeyHash", Base64.encodeToString(md.digest(), Base64.DEFAULT))
}
} catch (e: Exception) {
Log.e("KeyHash", e.message ?: "error")
} // 추가
}이제 앱 실행 후, 로그에서 나오는 키 해시를 콘솔에 등록하면 해결됩니다.

Logcat에서 xxxxxxxxxxxxxxxxxxxxxxxx= 같은 문자열이 출력됩니다.
참고:
keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -storepass android -keypass android | openssl sha1 -binary | openssl base64전 위 명령어로 나오는 키로 적용해보았지만 문제가 해결되지 않아서,
MainActivity에 코드를 넣어서 앱의 키 해시 확인하는 방법으로 해결했습니다.
2. 카카오 개발자 콘솔에 등록
- 카카오 개발자 콘솔 → 앱 > 앱 설정 > 앱 > 플랫폼 키 > 네이티브 앱 키 → Android 앱 정보에서 키 해시 추가

(Kakao Developers 메뉴가 바뀌어서 찾기에 시간이 조금 걸렸어요)
[앱 설정 > 앱 > 플랫폼 키] 메뉴로 들어가줍니다.

네이티브 앱 키로 들어가줍니다.


스크롤 해서 Android 앱 정보에서 ‘키 해시’를 찾아줍니다.

‘키 해시’에 로그에서 나오는 키 해시 값을 입력해줍니다.

제~일 하단에 저장 버튼은 꼭! 눌러줘야 해요.
이렇게 해서 다시 카카오 로그인을 시도하면, 해당 에러는 해결됩니다~
Tags: