Przejdź do treści

Ponowienia bez powielania skutków

2026-11-15

Użytkownik chce zwiększyć limit z 20 do 30. Klika „Dodaj 10”. Serwer zapisuje zmianę, ale odpowiedź nie dociera do panelu. Na ekranie nadal widać oczekiwanie.

Panel próbuje jeszcze raz. Jeśli serwer ponownie doda 10, limit wzrośnie do 40. Użytkownik chciał jednej zmiany, a system wykonał dwie.

W poprzednim artykule przyglądaliśmy się znaczeniu potwierdzeń. Tutaj pójdziemy krok dalej. Co ma zrobić serwer, gdy otrzyma ponowioną prośbę?

Ta sama prośba czy kolejna zmiana?

Dwa kliknięcia „Dodaj 10” mogą oznaczać różne rzeczy. Użytkownik mógł świadomie zwiększyć limit dwa razy. Panel mógł też ponowić jedno żądanie, bo nie dostał odpowiedzi. Sama treść polecenia wygląda w obu przypadkach tak samo.

Dlatego panel nadaje każdej nowej operacji numer, na przykład limit-42. Zachowuje go przy kolejnych próbach wysłania tej samej prośby.

Pierwsza próba: limit-42 — dodaj 10
Ponowienie:    limit-42 — dodaj 10
Nowa decyzja:  limit-43 — dodaj 10

Serwer może dzięki temu rozpoznać, do której sprawy wraca panel. Panel musi pamiętać numer również po swoim restarcie. Jeśli zastąpi go nowym, serwer potraktuje prośbę jako kolejną operację.

Serwer zachowuje wynik

Przy pierwszej obsłudze serwer zapisuje zmianę limitu oraz informację, co zrobił w ramach limit-42.

Operacja limit-42 zakończona.
Limit zwiększony z 20 do 30.

Gdy pojawi się ponowienie, serwer odczytuje ten wynik i odsyła go panelowi. Limit pozostaje 30.

Po utracie odpowiedzi panel ponawia operację limit-42. Serwer odczytuje zapisany wynik 30 i odsyła go do panelu.

To odpowiedź na pytanie „jak zakończyła się moja operacja?”. Jeśli ktoś później zwiększy limit do 50, wynik limit-42 nadal będzie mówił o zmianie do 30. Bieżący limit można odczytać osobno.

Numer operacji wiążemy także z jej autorem i treścią. Ten sam numer u dwóch różnych klientów nie powinien łączyć ich spraw. Tożsamość klienta serwer ustala podczas uwierzytelniania, czyli sprawdzania, kto wysyła żądanie.

A jeśli panel wyśle limit-42, ale tym razem poprosi o dodanie 15? Serwer zgłasza sprzeczność. Pod tym numerem ma już prośbę o dodanie 10. Zmiana rodzaju polecenia lub wskazanego obiektu również wymaga wyjaśnienia.

Co, jeśli dwie próby dotrą jednocześnie?

Wyobraźmy sobie, że żądania obsługują dwie kopie serwera. Obie sprawdzają bazę i obie widzą, że limit-42 jeszcze tam nie ma. Gdyby każda od razu dodała 10, znów otrzymalibyśmy 40.

Dlatego sprawdzenie i późniejszy zapis to za mało. W tym przykładzie baza pozwala zająć numer danej operacji tylko jednej próbie. Pozostała czeka na rozstrzygnięcie, zamiast samodzielnie zmieniać limit.

Zajęcie numeru, dodanie 10 i zachowanie wyniku odbywają się w jednej transakcji. Transakcja oznacza tutaj, że baza zatwierdzi wszystkie te zmiany razem albo wycofa je wszystkie.

Dwie próby konkurują o zapis tej samej operacji. Pierwsza zapisuje zmianę i wynik, a druga odczytuje wynik po zatwierdzeniu.

Po zatwierdzeniu pierwszej próby druga odczytuje wynik 30. Jeśli pierwsza się nie powiedzie i baza ją wycofa, druga może przejąć obsługę.

Nie zawsze da się poczekać na rozstrzygnięcie w czasie jednego żądania. Wtedy panel może dostać informację, że trzeba spróbować później. Przy następnej próbie nadal używa limit-42.

Przerwa w pracy serwera nie musi oznaczać kolejnej zmiany

Ważny jest moment przerwania pracy.

Jeśli serwer zatrzyma się przed zatwierdzeniem transakcji, baza wycofa rozpoczęte zmiany. Następna próba będzie mogła wykonać operację.

Jeśli zatrzyma się po zatwierdzeniu, ale przed wysłaniem odpowiedzi, zmiana i wynik już są zapisane. Następna próba odczyta wynik.

Zerwanie połączenia podczas zatwierdzania może pozostawić sam serwer bez wiedzy, która z tych sytuacji zaszła. Numer operacji pozwala wrócić do bazy i to sprawdzić.

Czy wystarczy wysłać „ustaw na 30”?

To może ułatwić sprawę. Dwukrotne ustawienie limitu na 30 daje wartość 30, jeśli w międzyczasie nikt jej nie zmienił. Tę właściwość nazywamy idempotencją — powtórzenie działania nie dodaje kolejnego skutku.

Nie rozwiązuje to jednak każdej sytuacji. Ktoś mógł po pierwszym ustawieniu zmienić limit na 50. Spóźniona kopia starego polecenia „ustaw na 30” nadpisałaby tę nowszą decyzję.

W naszym przykładzie zapamiętanie operacji pozwala rozpoznać dawną prośbę także wtedy, gdy jej ponowne wykonanie zmieniłoby obecny stan. Rozpoznawanie powtórzeń nazywamy deduplikacją. Zachowany wynik pozwala dodatkowo powiedzieć klientowi, co stało się z jego prośbą.

Pamięć operacji ma znaczenie

Załóżmy, że po siedmiu dniach serwer usuwa zakończone operacje. Ósmego dnia dociera stara kopia limit-42. Jeśli serwer uzna brak wpisu za nową prośbę, może ponownie dodać 10.

Dlatego usługa powinna jasno określać, jak długo rozpoznaje ponowienia i co robi z żądaniami, które przychodzą później. Siedem dni jest tu przykładową wartością. Potrzebny czas zależy od tego, jak długo klient ponawia prośby i jak długo wiadomości mogą czekać po drodze.

Gdy wynik został już zapomniany, trzeba ustalić stan operacji inną drogą. Nadanie nowego numeru w ciemno może doprowadzić do kolejnej zmiany.

Kiedy takie rozwiązanie chroni przed powtórzeniem?

W opisanej historii limit i wynik operacji są w jednej wspólnej bazie, z której korzystają wszystkie kopie serwera. To pozwala zapisać je razem i rozstrzygać równoczesne próby. Baza musi zachować zatwierdzony zapis po rozpatrywanym restarcie.

Numer operacji jest unikalny dla danego klienta, a serwer porównuje rodzaj polecenia, obiekt i wartości. Zmiana limitu musi również poprawnie współpracować z innymi operacjami na tym limicie. Szczegóły transakcji zależą od użytej bazy.

Usługa powinna określić także, które odmowy i błędy zapamiętuje. Na przykład prośba odrzucona z powodu braku uprawnień nie powinna nagle wykonać się po tygodniu tylko dlatego, że uprawnienia się zmieniły. Ponowienia trzeba więc rozpatrywać razem z regułami przyjmowania operacji.

Gdy działanie wychodzi poza bazę, potrzebujemy dodatkowych ustaleń. Urządzenie może wykonać polecenie, a odpowiedź o tym może zginąć. Zapis w bazie serwera sam nie rozstrzygnie, co zrobiło urządzenie. Odbiorca powinien umieć rozpoznać powtórzenie albo pozwalać sprawdzić wynik.

Podobnie długie zadanie wymaga sposobu wznowienia pracy po awarii. Krótka transakcja z tego przykładu obejmuje jedynie zapis zmiany limitu i jej wyniku.

Źródła i zakres

Historia limitu jest przykładem koncepcyjnym przygotowanym do tego tekstu. Pokazuje wymagania wobec obsługi ponowień. Nie przedstawia wyniku testu ani gotowego mechanizmu Junexis.

Materiał AWS opisuje identyfikatory nadawane przez klienta, rozpoznawanie tej samej intencji i atomowe zachowanie informacji o operacji. Dokumentacja Stripe pokazuje konkretny kontrakt API v1, w tym zwracanie zapisanego wyniku, porównywanie parametrów i usuwanie kluczy po określonym czasie. Zasady zapamiętywania błędów zależą od kontraktu danej usługi.

Źródła zewnętrzne sprawdzono 13 listopada 2026.