문제 해결
중복·지연 응답에도 급수가 반복되지 않도록
- 문제
- MQTT QoS 1은 같은 메시지를 다시 보낼 수 있고, 네트워크 지연으로 회신 순서가 바뀔 수 있습니다. 그대로 반영하면 센서 값이 중복 저장되거나, 결과만 유실된 급수를 재시도해 물이 두 번 공급될 수 있었습니다.
- 해결
- 명령을 DB에 저장하고 커밋이 끝난 뒤에만 MQTT로 발행했습니다. 회신은 requestId·장치 ID·명령 종류로 대조하고 QoS 1 재전송은 messageId로 걸러냈으며, 부분 실패 시에는 자동 급수를 멈추고 명령 이력과 알림으로 원인을 남겼습니다.
- 결과
- 급수량 미설정·물 부족·중복 재전송·늦은 회신·장치 불일치·명령 실패를 단위 테스트로 확인했습니다. 같은 상태 전이 구조를 광량 확보, 자동 송풍, 성장 사진 촬영에도 적용했습니다.
핵심 코드
저장소에서 그대로 발췌했습니다 · potner-server · Server-master
완료된 명령으로 다음 단계 결정 — 체인 상태 테이블 없이, 회신된 명령의 종류와 목적지만으로 급수·송풍·복귀를 이어갑니다.
* <p>체인 상태를 따로 저장하지 않는다. 다음 단계는 회신된 명령의 속성(종류·목적지·발행 주체)
* 만으로 정해지므로, 상태 테이블을 두면 명령 이력과 어긋날 자리만 생긴다. 서버가 재시작해도
* 회신이 도착하면 체인이 그대로 이어진다.
// ...
private void continueChain(DeviceCommandCompletedEvent event) {
if (event.commandType() == DeviceCommandType.NAVIGATE
&& event.destination() == RobotLocationType.WATER_STATION) {
commandService.issueAuto(event.plantId(), new IssueDeviceCommandRequest(
DeviceCommandType.WATER, null, null), CommandPurpose.WATERING);
log.info("Auto watering run: arrived at station, watering: plantId={}", event.plantId());
return;
}
// ...
if (event.commandType() == DeviceCommandType.WATER) {
if (properties.autoDryingEnabled()) {
commandService.issueAuto(event.plantId(), new IssueDeviceCommandRequest(
DeviceCommandType.FAN, null, null), CommandPurpose.WATERING);
log.info("Auto watering run: watered, ventilating: plantId={}", event.plantId());
return;
}
returnHome(event, "watered");
return;
}커밋이 끝난 명령만 발행 — 장치가 몇 ms 만에 회신해도 결과 처리기가 requestId를 찾을 수 있도록, 명령 저장이 커밋된 뒤에 MQTT로 내보냅니다.
/**
* 저장이 커밋된 명령을 MQTT 로 내보낸다.
*
* <p>{@code AFTER_COMMIT} 이 필요한 이유는 순서다. 라즈베리는 BUSY 회신을 몇 ms 만에 보낼 수
* 있어, 커밋 전에 발행하면 결과 처리기가 아직 없는 requestId 를 찾다 버린다.
// ...
@TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
public void onCommandIssued(DeviceCommandIssuedEvent event) {
Object payload = switch (event.commandType()) {
// ...
};
commandPublisher.publish(
event.deviceUid(),
new RobotCommand(event.commandType().commandName(), payload)
);
}회신을 반영하기 전 검증 순서 — 요청·장치·명령 종류를 대조하고, QoS 1 재전송은 상태 검사보다 먼저 messageId로 걸러냅니다.
* <p>검증 순서가 중요하다. 중복(재전송)을 상태 검사보다 먼저 봐야 한다 — QoS 1 재전송이
* ALREADY_COMPLETED 로 찍히면 "다른 회신이 두 번 왔다" 는 가짜 신호가 남는다.
*
* <p>{@code TIMED_OUT} 위에는 덮어쓴다. 타임아웃은 서버의 추정이고 회신은 물리적 사실이다.
* 실제 급수량이 일기에 실리므로 늦은 회신을 버리면 기록이 틀어진다.
// ...
DeviceCommand command = commandRepository.findById(message.requestId()).orElse(null);
if (command == null) {
return CommandResultApplyOutcome.UNKNOWN_REQUEST;
}
if (!command.getDeviceUid().equals(topicDeviceUid)) {
return CommandResultApplyOutcome.DEVICE_MISMATCH;
}
if (command.getCommandType() != topicCommandType) {
return CommandResultApplyOutcome.TYPE_MISMATCH;
}
if (message.messageId().toString().equals(command.getResultMessageId())) {
return CommandResultApplyOutcome.DUPLICATE;
}
if (command.getStatus().isTerminal()) {
return CommandResultApplyOutcome.ALREADY_COMPLETED;
}관련 테스트
저장소의 테스트 메서드입니다
AutoWateringOrchestratorTest.java5개
- 급수량이 설정되지 않았으면 체인을 시작하지 않음
skipsTheRunWhenNoWateringAmountIsConfigured - 스테이션 물이 부족하면 시작하지 않음
skipsTheRunWhenTheStationReportsWaterLow - 명령이 실패하면 재시도 없이 체인 중단
failureStopsTheRunWithoutRetry - 송풍이 실패해도 로봇은 대기 장소로 복귀
ventilationFailureStillSendsTheRobotHome - 사용자가 직접 내린 명령은 자동 체인을 잇지 않음
userIssuedCommandsNeverContinueTheChain
DeviceCommandResultServiceTest.java4개
- 같은 messageId의 재전송은 무시
ignoresADuplicateRedelivery - 타임아웃 뒤 늦게 온 회신은 실제 결과로 반영
overwritesATimedOutCommandWithTheLateResult - 다른 장치에서 온 회신 거부
rejectsAResultFromADifferentDevice - 알 수 없는 requestId 거부
rejectsAnUnknownRequestId
PotnerApplicationTests.java1개
- 같은 센서 메시지가 동시에 두 번 와도 한 건만 저장 (Testcontainers MySQL)
concurrentDuplicateMessageStoresOnlyOneReading
