Równoczesna edycja rekordów w aplikacji webowej: jak zapobiec utracie zmian
Dwóch współpracowników otwiera to samo zamówienie, każdy zmienia coś innego i obaj klikają Zapisz. Jeśli aplikacja po prostu zapisuje cały formularz, drugi zapis po cichu nadpisuje pierwszy. Nikt nie widzi błędu, zmiana po prostu znika. Równoczesna edycja rekordów to więc częsty, ale często pomijany problem systemów wewnętrznych, CRM, aplikacji rezerwacyjnych i do obsługi zamówień.
Krótka odpowiedź: aplikacja webowa nie powinna polegać na zasadzie „wygrywa ostatni zapis”. Każdy rekord powinien mieć wersję, a serwer powinien odrzucić zapis, jeśli rekord zmienił się od momentu otwarcia formularza. Użytkownik dostaje wtedy zrozumiały ekran konfliktu zamiast cichej utraty danych. Wyłączne blokowanie rekordów i krótkie blokady w bazie danych stosuj tylko tam, gdzie naprawdę mają sens.
Czym jest utrata zmian i dlaczego zwykle nikt jej nie zauważa
Specyfikacja HTTP nazywa to zjawisko problemem „lost update”: jeden klient przypadkowo nadpisuje pracę innego klienta, który działał równolegle (RFC 9110, sekcja 13). Notatka W3C opisuje go na prostej historii: Ron i Shirley wczytują ten sam dokument, Ron zapisuje swoje zmiany, potem Shirley zapisuje swoje i zmiany Rona przepadają, bo ona nigdy ich nie widziała (W3C Note: Detecting the Lost Update Problem).
Problem jest podstępny, bo nie wywołuje błędu. Aplikacja zgłasza oba zapisy jako udane. Różnica wychodzi na jaw dopiero później, na przykład gdy towar trafia pod stary adres albo klient dostaje ofertę z pierwotną ceną.
Dlaczego sama baza danych tego nie rozwiąże
Transakcje w bazie danych chronią operacje trwające ułamek sekundy. Edycja formularza trwa jednak minuty i składa się z dwóch osobnych żądań: wczytania i zapisu. Dokumentacja Ruby on Rails dotycząca blokowania optymistycznego wprost zaleca więc dodanie numeru wersji do formularza jako ukrytego pola, aby kontrola działała między żądaniami webowymi (Rails API: Optimistic Locking). Ta sama zasada obowiązuje w każdym frameworku.
Praktyczny przykład: zamówienie edytowane przez dwie osoby
Przykład poglądowy, a nie rzeczywisty przypadek klienta.
- O 9:00 Jana z działu sprzedaży otwiera zamówienie nr 1042, bo klient zadzwonił ze zmianą adresu dostawy.
- O 9:02 Piotr z magazynu otwiera to samo zamówienie i zmienia termin wysyłki.
- O 9:05 Jana zapisuje nowy adres.
- O 9:07 Piotr zapisuje formularz, który wciąż zawiera stary adres. Bez kontroli wersji zmiana Jany zostaje nadpisana.
Z kontrolą wersji serwer odrzuca zapis Piotra, a aplikacja pokazuje mu komunikat: „W międzyczasie, o 9:05, zamówienie edytowała Jana. Zmienił się adres dostawy.” Piotr widzi aktualny stan, ponownie wpisuje tylko termin wysyłki i zapisuje. Obie zmiany zostają zachowane.
Możliwe rozwiązania i kiedy którego użyć
W3C rozróżnia dwa główne podejścia: edycję nieblokującą z automatycznym wykrywaniem konfliktu przy zapisie oraz edycję zarezerwowaną, w której rekord może edytować naraz tylko jedna osoba. To, które jest lepsze, zależy głównie od tego, czy zmiany łatwo scalić i jak długo trwa edycja (W3C Note).
| Podejście | Kiedy pasuje | Główne ryzyko |
|---|---|---|
| Wygrywa ostatni zapis | Dane edytowane tylko przez jedną osobę, np. ustawienia osobiste | Cicha utrata zmian, gdy krąg użytkowników się poszerzy |
| Kontrola wersji przy zapisie (blokowanie optymistyczne) | Większość formularzy: zamówienia, klienci, oferty, umowy | Użytkownik musi czasem rozwiązać konflikt |
| Edycja wyłączna (rezerwacja rekordu) | Długie teksty lub dokumenty trudne do scalenia | Zapomniane blokady blokują współpracowników; potrzebny limit czasu i zarządzanie blokadami |
| Krótka blokada lub operacja atomowa w bazie danych | Liczby zmieniane jednocześnie przez wiele osób: stan magazynu, pojemność, saldo kredytu | Oczekiwanie przy dużym obciążeniu; konieczność powtórzenia transakcji |
Nawet blokada wyłączna nie usuwa potrzeby kontroli wersji. W3C zwraca uwagę, że w praktyce blokady są zwalniane po upływie czasu lub przez administratora, bo ludzie o nich zapominają albo tracą połączenie, dlatego wykrywanie konfliktów nadal jest potrzebne.
Jak wdrożyć kontrolę wersji w 6 krokach
1. Spisz rekordy edytowane przez kilka osób lub systemów
Zacznij od tych, w których utrata zmiany ma skutki finansowe lub dla klienta: zamówienia, oferty cenowe, karty klientów, terminy i pozycje magazynowe. Dodaj też importy, integracje i automatyzacje, które zapisują dane w tych rekordach.
2. Dodaj do każdego rekordu numer wersji
Najprościej użyć liczby całkowitej, która przy każdej zmianie rośnie o jeden. Rails w ten sposób wykorzystuje kolumnę lock_version i przy nieaktualnym zapisie zgłasza błąd StaleObjectError, pozostawiając rozwiązanie konfliktu aplikacji (Rails API). Czas ostatniej modyfikacji to słabszy wybór: RFC 9110 zauważa, że znacznik czasu z rozdzielczością jednej sekundy może nie odróżnić dwóch zmian wykonanych w tej samej sekundzie.
3. Sprawdzaj wersję na serwerze w jednym poleceniu
Formularz wysyła wersję, którą widział użytkownik. Serwer zapisuje zmianę tylko warunkowo, na przykład:
UPDATE orders SET delivery_address = $1, version = version + 1
WHERE id = $2 AND version = $3;
Jeśli polecenie nie zmieni żadnego wiersza, oznacza to konflikt. W PostgreSQL przy domyślnym poziomie Read Committed druga równoczesna aktualizacja czeka na pierwszą i ponownie ocenia warunek WHERE na zaktualizowanym wierszu (PostgreSQL: Transaction Isolation). Nieaktualna wersja niczego więc nie zapisze. Nie realizuj kontroli jako „wczytaj, porównaj, a potem zapisz” w oddzielnych krokach, bo między nimi może wkraść się zmiana.
4. W API używaj ETag i If-Match
Jeśli rekordy edytują aplikacje mobilne lub integracje, serwer wysyła wersję w nagłówku ETag, a klient zwraca ją przy zmianie w nagłówku If-Match. RFC 9110 wprost stwierdza, że ETag może opierać się na wewnętrznym numerze rewizji, że If-Match ocenia się za pomocą silnego porównania i że przy niezgodności serwer nie może wykonać żądanej zmiany; może odpowiedzieć statusem 412 Precondition Failed (RFC 9110). Jeśli chcesz wymagać żądań warunkowych, status 428 Precondition Required służy właśnie zapobieganiu utracie zmian, a odpowiedź powinna wyjaśniać, jak ponownie wysłać żądanie (RFC 6585).
5. Zaprojektuj ekran konfliktu
Konflikt to normalna sytuacja, a nie błąd systemu. Pokaż, kto i kiedy zmienił rekord, które pola się różnią, i zaproponuj jasny następny krok: wczytanie aktualnej wersji i ponowne naniesienie własnych zmian. Nigdy nie odrzucaj tekstu wpisanego przez użytkownika, pozwól go przynajmniej skopiować.
6. Zmieniaj liczby atomowo i przygotuj ponawianie
W przypadku stanów magazynowych czy pojemności nie wysyłaj z formularza nowego stanu („zostało 7 szt.”), lecz operację („odejmij 3 szt.”), którą serwer wykona w jednej transakcji. Jeśli używasz bardziej rygorystycznych poziomów Repeatable Read lub Serializable, PostgreSQL może przerwać transakcję z powodu konfliktu, a aplikacja powinna powtórzyć ją od początku; błędy serializacji mają kod SQLSTATE 40001 (PostgreSQL). Jawne blokady, takie jak SELECT FOR UPDATE, mogą blokować innych użytkowników, dlatego utrzymuj je jak najkrócej.
Kompromisy, z którymi trzeba się liczyć
- Więcej pracy nad interfejsem: ekran konfliktu i porównanie pól to osobna funkcja, którą trzeba zaprojektować i przetestować.
- Okres przejściowy dla integracji: starszy klient, który nie wysyła wersji, zacznie otrzymywać błędy po wprowadzeniu obowiązkowej kontroli. Zaplanuj okres przejściowy i dokumentację.
- Scalanie na poziomie pól: automatyczne scalanie zmian w różnych polach jest wygodne, ale musi uwzględniać zależności, na przykład między ceną a rabatem.
- Blokady a płynność pracy: edycja wyłączna zmniejsza liczbę konfliktów, ale ludzie czekają, a zapomniane blokady się mnożą.
Najczęstsze błędy
- Kontrola wersji tylko w przeglądarce, a nie na serwerze.
- Wersja nie rośnie przy importach, integracjach ani masowych zmianach z panelu administracyjnego.
- Formularz wysyła wszystkie pola, również niezmienione, więc nadpisuje także to, czego użytkownik w ogóle nie edytował.
- Automatyczne ponawianie zapisu po konflikcie z nieaktualnymi danymi, które jedynie maskuje konflikt.
- Ogólny komunikat „Wystąpił błąd” i utracona, niezapisana treść.
- Blokady bez limitu czasu i bez możliwości ich zwolnienia.
Lista kontrolna przed wdrożeniem
- Mamy listę rekordów edytowanych przez kilka osób lub systemów.
- Każdy taki rekord ma numer wersji zmieniany przy każdym zapisie, także przez integracje.
- Serwer zapisuje warunkowo i przy niezgodności wersji niczego nie zmienia.
- API zwraca ETag, przyjmuje If-Match i przy konflikcie odpowiada statusem 412.
- Użytkownik widzi, kto i co zmienił, i nie traci wpisanych danych.
- Stany magazynowe i pojemności zmieniają się operacjami atomowymi.
- Przeprowadziliśmy test z dwoma oknami przeglądarki i równoczesnymi żądaniami API.
- Rejestrujemy konflikty, aby widzieć, gdzie występują najczęściej.
Najczęściej zadawane pytania
Czy nie wystarczy, że aplikacja korzysta z transakcji w bazie danych?
Nie. Transakcja chroni jedno żądanie do serwera. Utrata zmian powstaje między otwarciem formularza a jego zapisem, czyli w obrębie dwóch żądań. Do tego potrzebny jest numer wersji wysyłany razem z formularzem.
Czy nie prościej zablokować rekord, gdy ktoś go otworzy?
Czasem tak, zwłaszcza przy długich dokumentach trudnych do scalenia. Przy zwykłych formularzach blokady często jednak blokują współpracowników i zostają zawieszone. Nawet przy blokadach zalecamy pozostawienie kontroli wersji jako zabezpieczenia.
Czy kontrolę wersji można dodać do istniejącej aplikacji?
Zwykle tak, stopniowo. Zacznij od typu rekordu o największym znaczeniu, dodaj wersję, zapis warunkowy i ekran konfliktu. Integracje przełącz na obowiązkową kontrolę dopiero po okresie przejściowym. Nakład pracy zależy od tego, ile miejsc zapisuje dane w rekordzie.
Jak sprawdzić, czy problem nas dotyczy?
Otwórz ten sam rekord w dwóch oknach przeglądarki, w każdym zmień inne pole i zapisz oba. Jeśli po odświeżeniu strony jedna zmiana zniknęła bez ostrzeżenia, aplikacja dopuszcza utratę zmian.
Potrzebujesz aplikacji, która nie gubi zmian?
Projektujemy i rozwijamy aplikacje webowe na zamówienie oraz oprogramowanie dla firm tak, aby wiele osób mogło pracować na tych samych danych bez cichego nadpisywania. Jeśli rekordy zmieniają także inne systemy, pomożemy z integracjami API z kontrolą wersji. Opisz nam przez formularz kontaktowy, gdzie znikają Twoje zmiany. Więcej praktycznych poradników znajdziesz na naszym blogu.
Źródła
- RFC 9110: HTTP Semantics (IETF), części dotyczące żądań warunkowych, ETag, If-Match i statusu 412
- RFC 6585: Additional HTTP Status Codes (IETF), status 428 Precondition Required
- PostgreSQL Documentation: Transaction Isolation
- Ruby on Rails API: ActiveRecord::Locking::Optimistic
- W3C Note: Detecting the Lost Update Problem Using Unreserved Checkout