여려분이 카카오톡 Access Token 을 빠르게 재발급 받고 싶을떄 사용하는 🐯 KakaoTokenProvider 사용 가이드

[moonjun1]

🐯 KakaoTokenProvider 사용 가이드

카카오 액세스 토큰을 쉽게 발급받을 수 있는 유틸리티입니다.

🚀 빠른 시작

1. 의존성 주입

@Service
public class YourService {
@Autowired
private KakaoTokenProvider kakaoTokenProvider;

}

2. 토큰 발급 (기본 사용법)

public void yourMethod() {
    // 카카오 ID로 액세스 토큰 발급
    String accessToken = kakaoTokenProvider.getAccessToken("12345678");
// 이제 accessToken으로 카카오 API 호출하세요!

}

📖 제공하는 메서드

getAccessToken(String kakaoId)

가장 많이 사용할 메서드

String token = kakaoTokenProvider.getAccessToken("12345678");

• 파라미터: 사용자의 카카오 ID (String)
• 리턴: 카카오 액세스 토큰 (String)
• 용도: 카카오 API 호출 시 Authorization 헤더에 사용

getAccessToken(User user)

User 객체가 이미 있을 때 사용

User user = userRepository.findById(1L);
String token = kakaoTokenProvider.getAccessToken(user);

• 파라미터: User 엔티티 객체
• 리턴: 카카오 액세스 토큰 (String)

validateAccessToken(String accessToken)

토큰 유효성 검증이 필요할 때

boolean isValid = kakaoTokenProvider.validateAccessToken(accessToken);
if (isValid) {
    // 토큰이 유효함
}

💡 실제 사용 예시

카카오톡 메시지 발송

@Service
public class MessageService {
@Autowired
private KakaoTokenProvider kakaoTokenProvider;

public void sendKakaoMessage(String kakaoId, String message) {
    // 1. 액세스 토큰 발급
    String accessToken = kakaoTokenProvider.getAccessToken(kakaoId);
    
    // 2. 카카오 메시지 API 호출
    HttpHeaders headers = new HttpHeaders();
    headers.setBearerAuth(accessToken);
    headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
    
    // 3. 메시지 발송 로직
    // ... 카카오 API 호출 코드
}

}

사용자 정보 조회

@Service
public class KakaoUserService {
@Autowired
private KakaoTokenProvider kakaoTokenProvider;

public Map<String, Object> getKakaoUserInfo(User user) {
    // 1. 액세스 토큰 발급
    String accessToken = kakaoTokenProvider.getAccessToken(user);
    
    // 2. 카카오 사용자 정보 API 호출
    HttpHeaders headers = new HttpHeaders();
    headers.setBearerAuth(accessToken);
    
    HttpEntity<String> request = new HttpEntity<>(headers);
    
    ResponseEntity<Map> response = restTemplate.exchange(
        "https://kapi.kakao.com/v2/user/me",
        HttpMethod.GET,
        request,
        Map.class
    );
    
    return response.getBody();
}

}

배치 작업에서 사용

@Component
public class NewsDeliveryBatch {
@Autowired
private KakaoTokenProvider kakaoTokenProvider;

@Scheduled(cron = "0 0 9 * * *")  // 매일 오전 9시
public void sendDailyNews() {
    List<User> users = userRepository.findAll();
    
    for (User user : users) {
        try {
            // 각 사용자별로 토큰 발급
            String accessToken = kakaoTokenProvider.getAccessToken(user);
            
            // 뉴스 발송 로직
            sendNewsToKakao(accessToken, user);
            
        } catch (Exception e) {
            log.error("뉴스 발송 실패: userId = {}", user.getId(), e);
        }
    }
}

}

⚠️ 주의사항

1. 예외 처리

try {
    String accessToken = kakaoTokenProvider.getAccessToken(kakaoId);
    // 카카오 API 호출
} catch (AuthException e) {
    // 토큰 발급 실패 (사용자 없음, 리프레시 토큰 만료 등)
    log.error("카카오 토큰 발급 실패: {}", e.getMessage());
}

2. 토큰 저장하지 마세요

// ❌ 이렇게 하지 마세요
String accessToken = kakaoTokenProvider.getAccessToken(kakaoId);
// 어딘가에 저장...
// ✅ 이렇게 하세요 (매번 새로 발급)

public void someMethod(String kakaoId) {

String accessToken = kakaoTokenProvider.getAccessToken(kakaoId);

// 즉시 사용

}

3. 토큰은 일회용으로 사용

// ✅ 각 API 호출마다 새로 발급받으세요
String token1 = kakaoTokenProvider.getAccessToken(kakaoId);
callKakaoApi1(token1);
String token2 = kakaoTokenProvider.getAccessToken(kakaoId);

callKakaoApi2(token2);

🔧 발생할 수 있는 예외

예외	원인	해결방법
USER_NOT_FOUND	존재하지 않는 카카오 ID	올바른 사용자 ID 확인
KAKAO_TOKEN_INVALID	리프레시 토큰 만료/무효	사용자 재로그인 필요
KAKAO_TOKEN_INVALID	카카오 API 오류	잠시 후 재시도

💡 TIP: 이 토큰으로 카카오 모든 API를 사용할 수 있습니다. 메시지 발송, 사용자 정보 조회, 친구 목록 등!