배포 후 카카오 로그인 안될 때 해결 방법

앱을 개발하다 보면, 카카오 로그인은 비교적 쉽게 붙일 수 있는 소셜 로그인 기능 중 하나다.
개발 단계에서는 잘 작동하지만, 앱을 배포하고 나면 갑자기 카카오 로그인이 작동하지 않는 문제가 생길 수 있다.
나도 실제로 배포 후 이런 문제를 겪었고, 삽질 끝에 해결한 방법을 공유해본다.

---

증상

• 디버그 모드에서는 로그인 잘 됨.
• 하지만 릴리즈(배포) 버전에서는 아무런 반응 없이 실패하거나, 로그인 창 자체가 안 뜸.
• PlatformException이나 kakao_flutter_sdk 내부에서 실패 로그가 나오는 경우도 있음.

---

원인

배포된 앱에서는 key hash (키 해시) 값이 다르기 때문이다.
디버그 키와 릴리즈 키는 서로 다르기 때문에, 카카오 개발자 센터에 릴리즈 키 해시를 등록하지 않으면 배포 앱에서 인증이 실패하게 된다.

---

해결 방법

1. 릴리즈 키 해시 값 추출하기

keytool -exportcert -alias [키알리아스] -keystore [키스토어경로] -storepass [스토어비밀번호] -keypass [키비밀번호] | openssl sha1 -binary | openssl base64

• Mac 기준으로는 이런 형태다:

keytool -exportcert -alias your-key-alias -keystore ~/your-release-key.jks | openssl sha1 -binary | openssl base64

your-key-alias와 .jks 경로는 자신이 설정한 값에 따라 다르다.

---

2. 카카오 개발자 센터에서 키 해시 등록

• https://developers.kakao.com/console 에 접속
• 해당 앱 선택
• 플랫폼 > Android 설정에서, 위에서 얻은 릴리즈 키 해시를 추가해준다.

기존 디버그 키 해시도 같이 등록되어 있어야 한다.

---

3. 릴리즈 빌드로 다시 테스트

릴리즈 키 해시를 등록하고 나면, 다음과 같이 릴리즈 모드에서 정상적으로 카카오 로그인이 작동한다:

 

flutter build apk --release

또는

flutter run --release

---

마무리하며

처음엔 내가 잘못 구현했나 싶었지만, 원인은 배포된 앱의 릴리즈 키 해시가 등록되지 않아서였다.
소셜 로그인을 붙일 때는, 디버그용 키와 릴리즈용 키를 모두 등록해줘야 한다는 걸 잊지 말자.
나처럼 배포 후 로그인 안된다고 당황하지 말고, 키 해시부터 확인해보는 걸 추천한다.

---

혹시 이 글이 도움이 됐다면 댓글이나 공유도 언제든지 환영!
Flutter 배포 관련해서 궁금한 게 있다면 언제든지 질문 남겨줘요 

오늘도 즐코 빡코 !