Troubleshooting

문제발생시 아래를 참고해 주세요.

샘플앱 문제해결

  • 샘플앱이 설치가 되지 않는 경우

    샘플을 설치할 디바이스에 개발자 옵션 > USB 디버깅이 켜져 있어야 합니다.

  • 샘플앱 설치 중 INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES 에러가 발생한 경우

    기기에 다른 컴퓨터에서 빌드된 똑같은 샘플앱이 이미 설치가 된 경우입니다. 일반적으로 컴퓨터별 인증서는 다르기 때문에 인증서 불일치가 일어났습니다. 이 경우 기기에 설치된 샘플앱을 깨끗히 삭제한 후 재설치를 시도하시면 됩니다.

  • 샘플앱 수행 중 로그인이 되지 않고 처음 page로 돌아오는 경우

    • 로그캣에 "error":"misconfigured","error_description":"invalid android_key_hash or ios_bundle_id or web_site_url" 남았는지 확인합니다.
    • 위 로그와 함께 로깅된 android_key_hash라는 파람의 값과 샘플앱 키해시로 등록한 값이 일치하는 지 확인합니다. 로그에 찍히는 android_key_hash 파람은 URL 인코딩된 값이므로 이를 고려하여 비교하도록 합니다.
    • 두 키해시가 일치하지 않는다면, 샘플앱 설정을 참고하여 다시 등록합니다.
    • 두 키해시가 일치하지 한다면, 로그인을 시도한 계정과 키해시를 등록한 개발자 계정이 일치하는 지 확인합니다. 샘플앱은 해당 키해시를 등록한 개발자 계정으로만 로그인이 가능합니다.

사용자 관리 문제해결

  • 로그인이 되지 않는 경우 1
    • 로그캣에 "error":"misconfigured","error_description":"invalid android_key_hash or ios_bundle_id or web_site_url" 남았는지 확인합니다.
    • 앱 사인(sign)과정에 사용한 키를 설정 > 일반 > 플랫폼 > Android > 키 해시 에 등록한 상태인지 확인합니다.
    • 위 로그와 함께 로깅된 android_key_hash라는 파람의 값과 등록한 앱 키해시 값이 일치하는 지 확인합니다.
    • 키해시를 등록하지 않았거나, 두 키해시가 일치하지 않는다면, 앱 생성의 2.을 참고하여 다시 등록합니다.
  • 로그인이 되지 않는 경우 2
    • 로그캣에 Redirect URL: https://kauth.kakao.com/oauth/authorize? 남았는지 확인합니다.
    • 파라미터로 넘긴 client_id와 redirect_uri가 제대로 되었는지 확인합니다.
      • client_id는 설정 > 일반 > 앱 키 > 네이티브 앱 키와 일치해야 합니다.
      • redirect_uri는 kakao{client_id}%3A%2F%2Foauth와 일치해야 합니다.
  • 카카오톡으로 간편로그인을 할 수 없고 ID/password 입력창이 뜨는 경우

    카카오톡 앱의 버젼이 4.2.0 이상임을 확인합니다.

카카오스토리 문제해결

  • 스토리 상세보기 하단에 포스팅 출처 앱 이름 클릭시 아무 반응이 없는 경우

    • 기기에 해당 앱이 설치되어 있는지 확인합니다.
    • 설치된 경우라면, 시작하기 전에에 안내된 kakao[appkey]://kakaostory 스킴을 앱에 설정했는지 확인합니다.
    • 설치되지 않은 경우라면, 마켓 URL 설정했는지 확인합니다.
      • 메시지를 받은 기기가 Android인 경우라면 설정 > 일반 > 플랫폼 > Android > 마켓 URL을 설정했는지 확인합니다.
      • 메시지를 받은 기기가 iOS인 경우라면 설정 > 일반 > 플랫폼 > iOS > iPhone 앱 스토어 ID 또는 iPad 앱 스토어 ID를 설정했는지 확인합니다.
  • 스토리 상세보기 하단에 포스팅 출처 앱 이름 클릭시 기기에 해당 앱이 설치되어 있는데 앱으로 이동 버튼 클릭시 앱으로 이동하지 않고 마켓으로 이동하는 경우

    시작하기 전에에 안내된 kakao[appkey]://kakaostory 스킴을 앱에 설정했는지 확인합니다.

  • 사진 포스팅시 유효한 이미지 path를 주었는데도 이미지 path가 틀려 포스팅 할 수 없는 경우

    • KakaoStoryService#requestMultiUpload(com.kakao.KakaoStoryHttpResponseHandler, List)을 이용하여 업로드한 결과로 받은 path인지 확인합니다. 다른 이미지 path는 허용하지 않습니다.

카카오링크 문제해결

  • 앱으로 이동 버튼/링크 클릭에 아무 반응이 없는 경우

    • 메시지를 받은 기기에 해당 앱이 설치되어 있는지 확인합니다.
    • 설치된 경우라면, 시작하기 전에에 안내된 kakao[appkey]://kakaolink 스킴을 앱에 설정했는지 확인합니다.
    • 설치되지 않은 경우라면, 마켓 URL 설정했는지 확인합니다.
      • 메시지를 받은 기기가 Android인 경우라면 설정 > 일반 > 플랫폼 > Android > 마켓 URL을 설정했는지 확인합니다.
      • 메시지를 받은 기기가 iOS인 경우라면 설정 > 일반 > 플랫폼 > iOS > iPhone 앱 스토어 ID 또는 iPad 앱 스토어 ID를 설정했는지 확인합니다.
  • 기기에 해당 앱이 설치되어 있는데 앱으로 이동 버튼 클릭시 앱으로 이동하지 않고 마켓으로 이동하는 경우

    시작하기 전에에 안내된 kakao[appkey]://kakaolink 스킴을 앱에 설정했는지 확인합니다.

  • 웹으로 이동 버튼/링크 클릭시 "메세지를 발송한 앱의 설정(사이트 도메인)에 오류가 있어 메세지를 전송할 수 없습니다. 해당 앱의 관리자에게 문의하세요." 팝업이 뜨는 경우

    설정 > 일반 > 플랫폼 > > 사이트 도메인 에 설정한 도메인 값과 파라미터로 넘긴 URL의 도메인이 일치하는지 확인합니다. 도메인을 등록하지 않았거나 등록된 도메인과 다른 URL을 넘긴 경우 발생하는 에러입니다.

  • 마켓 파라미터 설정이 적용되지 않는 경우

    • 카카오톡 버젼이 4.5.0 이상인지 확인합니다.
      • 안드로이드 마켓 파라미터 설정은 안드로이드 카카오톡 4.5.0 이상부터 지원됩니다.
      • 그 미만 버젼에서 마켓 파라미터를 설정하고 카카오링크를 전송하여도 파람이 붙지 않은 등록된 마켓 url만 전달됩니다.

푸시 알림 문제해결

  • 푸시 토큰은 등록을 했는데 푸시 메시지를 보낼 수가 없는 경우.
    • 시작하기 전에 3. 구글 개발자 센터에 GCM 서비스 사용 등록에서 허용 IP가 any address가 되도록 설정했는지 확인합니다.

Last Modified : 2017-07-28