MQTT 연결이 끊기는 상황들
IoT 앱은 백그라운드에서도 기기 상태 알림을 받아야 한다. 그런데 MQTT 연결은 다양한 이유로 끊긴다:
- 스마트폰 화면이 꺼지고 앱이 백그라운드로 이동
- WiFi에서 LTE로 네트워크 전환
- 일시적인 인터넷 불안정
- 서버 점검이나 재시작
- Keep-Alive 타임아웃
이런 상황에서 연결이 자동으로 복구되어야 한다.
Keep-Alive
MQTT Keep-Alive는 클라이언트가 일정 간격으로 브로커에 “나 살아있어”(PINGREQ) 신호를 보내는 메커니즘이다. 브로커가 응답(PINGRESP)하지 않으면 연결이 끊겼다고 판단한다.
final connMessage = MqttConnectMessage()
.withClientIdentifier(clientId)
.keepAliveFor(60); // 60초 간격으로 ping
60초로 설정하면 60초 안에 서로 통신이 없으면 ping을 보낸다. AWS IoT Core의 기본 Keep-Alive 제한이 1200초이니 60초는 충분히 안전하다.
자동 재연결 설정
mqtt5_client는 자동 재연결을 지원한다:
_client.autoReconnect = true;
_client.resubscribeOnAutoReconnect = true; // 재연결 후 토픽 재구독
_client.onAutoReconnect = () {
print('MQTT 자동 재연결 시도 중...');
};
_client.onAutoReconnected = () {
print('MQTT 자동 재연결 성공');
// 재연결 후 처리가 필요한 작업
_resubscribeAllTopics();
};
앱 생명주기에 따른 MQTT 관리
앱이 백그라운드로 가거나 다시 포그라운드로 올 때 MQTT를 관리해야 한다:
// presentation/main/main_tab_controller.dart
class MainTabController extends GetxController with WidgetsBindingObserver {
@override
void onInit() {
super.onInit();
WidgetsBinding.instance.addObserver(this);
}
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
switch (state) {
case AppLifecycleState.resumed:
// 포그라운드로 돌아왔을 때
_reconnectIfNeeded();
break;
case AppLifecycleState.paused:
// 백그라운드로 갔을 때
// Android: MQTT 유지 (백그라운드 서비스 없으면 끊길 수 있음)
// iOS: 백그라운드에서 MQTT 유지 어려움
break;
default:
break;
}
}
void _reconnectIfNeeded() {
if (!_mqttService.isConnected) {
_mqttService.reconnect();
}
}
@override
void onClose() {
WidgetsBinding.instance.removeObserver(this);
super.onClose();
}
}
네트워크 상태 감지
connectivity_plus로 네트워크 변경을 감지한다:
// core/services/auth_manager.dart 에서 활용
Connectivity().onConnectivityChanged.listen((result) {
final isConnected = result != ConnectivityResult.none;
if (isConnected && !_mqttService.isConnected) {
// 네트워크 복구 시 MQTT 재연결
_mqttService.reconnect();
}
});
네트워크가 복구됐다고 해서 즉시 연결을 시도하면 실패할 수 있다. 약간의 딜레이를 주는 게 안전하다:
if (isConnected && !_mqttService.isConnected) {
await Future.delayed(const Duration(seconds: 2));
await _mqttService.reconnect();
}
Last Will Testament (LWT)
앱이 예기치 않게 종료되면 브로커가 LWT 메시지를 발행한다:
final connMessage = MqttConnectMessage()
.withClientIdentifier(clientId)
.withWillTopic('smarthome/app/$userId/presence')
.withWillMessage(jsonEncode({
'status': 'offline',
'timestamp': DateTime.now().millisecondsSinceEpoch,
}))
.withWillQos(MqttQos.atLeastOnce)
.withWillRetain();
정상 종료 시에는 직접 offline 메시지를 발행하고 연결을 끊는다:
Future<void> disconnect() async {
// 정상 종료 메시지
await publish(
'smarthome/app/$userId/presence',
jsonEncode({'status': 'offline'}),
retain: true,
);
_client.disconnect();
}
실제로 겪은 문제
iOS에서 앱이 백그라운드로 가면 MQTT 연결이 끊기는 문제가 있었다. iOS는 백그라운드 네트워크 연결을 적극적으로 제한하기 때문이다.
대안으로 FCM 푸시를 기본으로 쓰고, 앱이 포그라운드에 있을 때만 MQTT 연결을 유지하는 방식을 채택했다. 앱이 포그라운드에 있을 때는 MQTT로 실시간 상태를 받고, 백그라운드에서는 FCM으로 중요 알림만 받는 구조다.
다음 편부터는 데이터 레이어 파트다. Realm DB부터 시작한다.