Przejdź do treści

Co naprawdę potwierdza ACK?

2026-11-08

Wyobraźmy sobie usługę rezerwacji stanowiska. Kolejka dostarcza jej polecenie Reserve(resource-7). Proces odbiera wiadomość i odsyła ACK — potwierdzenie (ang. acknowledgment). Chwilę później, zanim zapisze rezerwację, uruchamia się ponownie po awarii.

Czy stanowisko zostało zarezerwowane?

W tym scenariuszu nie: proces zakończył się przed zapisem. Czy polecenie wróci z kolejki? Nie wynika to z samej nazwy ACK. Załóżmy, że nasz kontrakt pozwala kolejce po odebraniu tego potwierdzenia usunąć wiadomość. Wtedy potwierdziliśmy ją za wcześnie: nie mamy ani rezerwacji, ani obowiązku ponownego dostarczenia tego polecenia przez kolejkę.

To fikcyjny przykład projektowy, nie opis wykonanej próby Junexis. Pokazuje jednak konkretne pytanie: jakie zdarzenie już nastąpiło, gdy ktoś wysłał potwierdzenie?

Potwierdzenie ma wystawcę i zakres

W poprzednim artykule oddzieliliśmy działające połączenie od wykonanej operacji. Teraz dodajmy jeszcze rozróżnienie: kilka stron tego samego przepływu może wystawić różne potwierdzenia.

Kto odpowiada? Co odpowiedź może oznaczać zgodnie z kontraktem? Czego nie należy z niej wywnioskować automatycznie?
Stos transportowy Potwierdza dane w swoim zakresie protokołu. Że usługa zapisała rezerwację.
Pośrednik wiadomości Przyjął wiadomość na określonych warunkach. Że konsument wykonał polecenie.
Usługa wykonująca operację Przyjęła odpowiedzialność za obsługę. Że obsługa już się zakończyła.
Usługa po zapisie wyniku Zakończyła wskazaną operację i zachowała określony wynik. Że wszystkie późniejsze skutki poza jej granicą również zaszły.

To przykładowe granice, a nie jeden obowiązkowy protokół. W każdym wierszu trzeba przeczytać warunki odpowiedzi. Sam napis ACK, OK lub success nie zastąpi ich opisu.

Wydawca otrzymuje potwierdzenie przyjęcia od pośrednika, a aplikacja osobno zapisuje rezerwację i udostępnia wynik klientowi.

Na diagramie potwierdzenie pośrednika i odpowiedź o wyniku rezerwacji pochodzą z innych miejsc. Ich znaczenia nie można połączyć tylko dlatego, że obie odpowiedzi mówią o tej samej wiadomości.

Przyjęcie w pamięci a trwała odpowiedzialność

Wróćmy do procesu rezerwacji. Może on najpierw umieścić polecenie w lokalnym buforze, a dopiero później je obsłużyć. Odpowiedź „odebrano” po takim kroku może być prawdziwa. Nie wystarczy jednak do obietnicy „praca nie zginie po restarcie”, jeśli jedyna kopia oczekującego polecenia jest w pamięci procesu.

Jeśli usługa ma odpowiedzieć „przyjęto trwale”, potrzebuje najpierw osiągnąć zdefiniowaną granicę zapisu. Trzeba też określić, jak po restarcie znajdzie przyjętą pracę i kto podejmie jej obsługę. Sam rekord w bazie bez drogi odzyskania pracy nie opisuje jeszcze całego mechanizmu kontynuacji.

Dwie alternatywne historie: potwierdzenie przed zapisem i utrata pracy po restarcie oraz trwały zapis pracy przed potwierdzeniem z możliwością jej odczytu po restarcie.

Druga gałąź zakłada trwały zapis, który przetrwa rozpatrywany restart, oraz działający mechanizm odzyskania pracy. Pokazuje przyjęcie obowiązku obsługi. Nie pokazuje jeszcze wykonania rezerwacji ani odporności na każdą awarię magazynu danych.

Czy wystarczy przenieść ACK za zapis rezerwacji?

To usuwa jedno okno awarii, ale pozostawia inne. Rozważmy kolejność:

  1. Usługa zapisuje rezerwację.
  2. Proces kończy się przed odesłaniem potwierdzenia.
  3. Nadawca lub pośrednik ponawia dostawę, bo nie zna wyniku.

Rezerwacja już istnieje, lecz wiadomość może zostać obsłużona ponownie. Jeżeli powtórzenie ma być bezpieczne, potrzebujemy dodatkowo rozpoznać tę samą operację i określić, co zwrócić przy ponowieniu. Samo przesunięcie ACK na koniec nie zapewnia jednego wykonania skutku.

W prostym modelu bazodanowym można rozważyć wspólną transakcję dla zmiany stanu, identyfikatora operacji i jej wyniku. To założenie projektowe, nie gotowa gwarancja. Nie przenosi się automatycznie na działanie fizycznego urządzenia, zewnętrzną płatność lub inną usługę poza tą transakcją.

Szczegółami identyfikacji ponowień zajmiemy się w następnym tekście. Tutaj wystarczy zauważyć, że dobór momentu potwierdzenia i obsługa powtórzeń są dwoma powiązanymi zadaniami.

Dwie różne rozmowy w RabbitMQ

Dokumentacja RabbitMQ rozróżnia publisher confirms — potwierdzenia od brokera dla wydawcy — oraz consumer acknowledgements, czyli potwierdzenia konsumenta dla brokera. Są od siebie niezależne. Potwierdzenie publikacji nie dowodzi wykonania operacji przez konsumenta.1

Warunki trwałości również mają znaczenie. Dla trwałych wiadomości skierowanych do trwałych kolejek dokumentacja wiąże potwierdzenie z zapisem na dysk; dla quorum queues opisuje potwierdzenie przyjęcia przez kworum replik. Nie należy rozszerzać tych warunków na dowolną konfigurację. Wiadomość, której nie da się skierować do kolejki, też może otrzymać confirm; przy publikacji mandatory informacja o zwrocie poprzedza ACK.1

Przy ręcznym potwierdzaniu konsument wskazuje brokerowi dostawę, którą uznaje za obsłużoną. Broker nie odczytuje z tego faktu stanu bazy biznesowej. To kod konsumenta musi wysłać potwierdzenie po zdarzeniu wymaganym przez jego kontrakt. W trybie automatycznym znaczenie potwierdzenia dostawy jest inne — nie należy utożsamiać go z ręcznym ACK po zakończeniu pracy.1

Ten przykład dotyczy opisanych mechanizmów RabbitMQ. Nie jest deklaracją ich implementacji ani integracji w Junexis.

Akceptacja i zakończenie potrzebują różnych odpowiedzi

Dla dłuższej operacji uczciwą odpowiedzią może być:

operation_id: reserve-42
state: ACCEPTED

Pod warunkiem, że kontrakt wyjaśnia, jaka odpowiedzialność została przejęta. Klient nie powinien jeszcze pokazywać „stanowisko zarezerwowane”. Może pokazać „żądanie przyjęte” i później odczytać stan tej samej operacji.

Wynik końcowy mógłby mieć osobną postać:

operation_id: reserve-42
state: COMPLETED
outcome: RESERVED
resource_id: resource-7

Nazwy są poglądowe. Ważne jest powiązanie odpowiedzi z konkretną intencją oraz jasne znaczenie COMPLETED. Równie dobrze operacja może zakończyć się wynikiem UNAVAILABLE: obsłużenie polecenia nie musi oznaczać spełnienia prośby o zasób.

Zapytanie o status także wymaga kontraktu. Jak długo wynik jest przechowywany? Czy brak wpisu oznacza „nigdy nie przyjęto”, czy „nie mamy już informacji”? Jeżeli status jest nieznany, interfejs powinien to pokazać, zamiast zamieniać brak dowodu w sukces lub pewną porażkę.

Pięć pytań do przeglądu odpowiedzi

Przy najbliższym ACK w API, kolejce lub połączeniu między zadaniami sprawdź:

  • Kto potwierdza? Pośrednik, odbiorca transportu czy wykonawca operacji?
  • Co już zaszło? Odczyt, trwałe przyjęcie, akceptacja czy zapis skutku?
  • Co przetrwa restart? Który zapis i dla jakiego zakresu awarii?
  • Kto odpowiada za dalszy krok? I skąd odzyska pracę po przerwaniu procesu?
  • Jak ustalisz wynik po utracie odpowiedzi? Jaka tożsamość operacji, status i retencja pozwalają wrócić do tej samej sprawy?

ACK jest użyteczne, gdy zmniejsza niepewność o dokładnie nazwane zdarzenie. Nie kończy całej historii tylko dlatego, że dotarło. Przed uznaniem operacji za zakończoną trzeba wiedzieć, kto, co i na jakich warunkach potwierdził.

Źródła i zakres

Opis rezerwacji i odpowiedzi ACCEPTED / COMPLETED jest przykładem koncepcyjnym. Nie przedstawia publicznego API ani wdrożonego protokołu Junexis. Nie wykonano tu eksperymentu odpornościowego.


  1. RabbitMQ, sekcje „Are Publisher Confirms Related to Consumer Delivery Acknowledgements?”, „Consumer Acknowledgement Modes and Data Safety Considerations” oraz „When Will Published Messages Be Confirmed by the Broker?”. Potwierdzenia brokera i konsumenta dotyczą różnych granic; warunki trwałości zależą od konfiguracji. ↩↩↩