· Flutter 개발 · 6 min read

Flutter integration_test JWT 자동 갱신 - 401 동시 요청 경쟁 조건 검증

Flutter integration_test에서 JWT가 만료된 순간 MQTT·기기 API 요청이 동시에 401을 받을 때 refresh token을 한 번만 사용하고 원 요청을 안전하게 재실행하는 방법을 정리했다.

Flutter integration_test JWT 자동 갱신과 IoT 요청 재실행

Flutter integration_test에서 로그인 후 보일러 상태를 읽는 흐름만 통과시키면 JWT 만료 버그를 놓치기 쉽다. 실제 스마트홈 앱에서는 기기 목록, MQTT 세션, 알림 동기화 요청이 거의 동시에 나간다. 토큰이 만료된 순간 세 요청이 모두 401을 받으면 refresh token을 세 번 쓰거나, 한 요청만 재실행되고 나머지는 로그아웃되는 문제가 생긴다. 결론은 동시 401을 하나의 refresh 작업으로 합치고, 각 원 요청의 재실행까지 확인하는 것이다.

만료 토큰은 단독 요청보다 동시에 터진다

처음에는 API 클라이언트에서 401이면 곧바로 refresh()를 호출했다. 단일 테스트에서는 잘 됐다. 하지만 앱을 콜드 스타트하면 GET /devices, GET /spaces, MQTT 인증이 함께 시작된다. Fake 서버가 세 응답을 연달아 401로 반환하자 refresh API가 세 번 호출됐고, 서버는 두 번째 요청부터 이미 사용한 refresh token으로 판단했다.

상황잘못된 결과검증해야 할 기준
401 한 번요청만 실패refresh 후 원 요청 1회 재실행
401 세 번 동시 발생refresh 3회, 세션 삭제refresh 1회, 세 요청 모두 성공
refresh 실패무한 재시도저장소 삭제 후 로그인 화면 이동

핵심은 Future를 공유하는 것이다. 이미 갱신 중이면 새 refresh를 시작하지 않고 기존 Future를 기다린다. 아래 코드는 실제 프로젝트의 AuthInterceptor를 단순화한 형태다.

class TokenRefresher {
  TokenRefresher(this.authApi, this.storage);

  final AuthApi authApi;
  final TokenStorage storage;
  Future<String>? _refreshing;

  Future<String> refreshOnce() {
    final running = _refreshing;
    if (running != null) return running;

    final future = _refreshToken();
    _refreshing = future;
    future.whenComplete(() => _refreshing = null);
    return future;
  }

  Future<String> _refreshToken() async {
    final refreshToken = await storage.readRefreshToken();
    if (refreshToken == null) throw const AuthExpired();

    final token = await authApi.refresh(refreshToken);
    await storage.saveAccessToken(token.accessToken);
    await storage.saveRefreshToken(token.refreshToken);
    return token.accessToken;
  }
}

integration_test에서는 만료 순서를 직접 만든다

실제 인증 서버의 만료 시각을 기다리면 테스트가 느리고 불안정하다. FakeAuthApi에 401 응답 횟수와 refresh 호출 횟수를 넣고, 앱 시작 직후 세 요청을 동시에 발생시켰다.

testWidgets('동시 401은 refresh 한 번 후 모든 요청을 재실행한다',
    (tester) async {
  final auth = FakeAuthApi(
    unauthorizedCalls: 3,
    refreshedAccessToken: 'access-2',
  );
  await launchTestApp(authApi: auth);

  await tester.tap(find.byKey(const Key('open-dashboard')));
  await tester.pumpAndSettle();

  expect(auth.refreshCalls, 1);
  expect(auth.retriedPaths, containsAll(<String>[
    '/spaces',
    '/devices',
    '/mqtt/session',
  ]));
  expect(find.text('거실 보일러'), findsOneWidget);
  expect(find.text('로그인 만료'), findsNothing);
});

여기서 pumpAndSettle()만 호출하는 것은 충분하지 않다. Fake의 refresh Future를 테스트 안에서 완료시키지 않으면 앱이 계속 대기할 수 있다. 실제 헬퍼에서는 Completer<Token>을 외부에 노출해 refreshStarted를 확인한 뒤 완료시킨다. 또 재실행 요청에 이미 새 access token이 들어갔는지와 같은 요청이 두 번 이상 실행되지 않았는지를 별도로 기록했다.

refresh 실패도 성공 시나리오만큼 중요하다

refresh token이 만료된 경우 interceptor가 다시 401을 만들면 무한 루프가 시작된다. 재시도 횟수는 원 요청당 1회로 제한하고, 갱신 실패 시 flutter_secure_storage의 access·refresh token을 함께 지운 뒤 로그인 화면으로 보내야 한다. 테스트에서는 refreshThrows = true로 바꾸고, /devices가 두 번 이상 호출되지 않는지 확인했다.

주의할 점은 이 테스트가 서버의 JWT 서명 검증이나 실제 MQTT 브로커 세션까지 보장하지 않는다는 것이다. 목적은 토큰 만료 시 앱 내부의 동시성 계약을 고정하는 데 있다. 실기기에서는 앱 시작 시점, 백그라운드 복귀 시점에 각각 한 번씩 실제 refresh를 확인하고, CI에서는 Fake로 모든 요청의 순서를 반복하는 구성이 현실적이었다.

짧게 정리하면 401 감지 → refresh Future 공유 → access token 저장 → 원 요청 1회 재실행의 순서를 테스트에 남겨야 한다. refresh 호출 횟수만 1인지 보는 것보다, 동시에 실패한 IoT 요청 세 개가 모두 올바른 토큰으로 끝났는지까지 확인해야 세션 경쟁 조건을 잡을 수 있다.

Share:
Back to Blog