Ka\u017cdy programista pisze kod, kt\u00f3ry dzia\u0142a \u2013 do czasu, a\u017c pojawi si\u0119 b\u0142\u0105d. Wtedy zaczyna si\u0119 prawdziwy test architektury. Obs\u0142uga b\u0142\u0119d\u00f3w (error handling) to jeden z najbardziej niedocenianych aspekt\u00f3w backendu, a jego koszty s\u0105 cz\u0119sto ukryte g\u0142\u0119boko w bud\u017cetach operacyjnych. Z\u0142e podej\u015bcie do b\u0142\u0119d\u00f3w nie tylko frustruje u\u017cytkownik\u00f3w, ale generuje realne straty: wy\u017csze rachunki za chmur\u0119, spadek konwersji i d\u0142ug techniczny. W tym artykule przyjrzymy si\u0119 trzem powszechnym b\u0142\u0119dom, kt\u00f3re widz\u0119 w projektach ma\u0142ych i \u015brednich firm.<\/p>\n
Widok w logach pe\u0142en b\u0142\u0119d\u00f3w Za\u0142\u00f3\u017cmy, \u017ce Tw\u00f3j e-commerce ma endpoint zam\u00f3wienia. Gdzie\u015b w g\u0142\u0119bi logiki biznesowej kod rzuca wyj\u0105tkiem, gdy magazyn nie ma wystarczaj\u0105cej ilo\u015bci towaru. Je\u015bli z\u0142apiesz go w kontrolerze i zwr\u00f3cisz Stosuj architektur\u0119 warstwow\u0105 z dedykowanymi klasami b\u0142\u0119d\u00f3w. Na przyk\u0142ad: rzucaj Endpoint API zwraca Po pierwsze, bezpiecze\u0144stwo: wyciek szczeg\u00f3\u0142\u00f3w bazy danych lub struktury kodu u\u0142atwia ataki. Po drugie, UX: nie ka\u017cdy b\u0142\u0105d musi by\u0107 widoczny dla u\u017cytkownika. Je\u015bli podasz zbyt techniczny komunikat, u\u017cytkownik \u2013 zw\u0142aszcza w B2B \u2013 mo\u017ce straci\u0107 zaufanie. A je\u015bli Ty jako w\u0142a\u015bciciel produktu widzisz w logach dok\u0142adny zapytanie SQL, to nara\u017casz si\u0119 na wyciek danych wra\u017cliwych.<\/p>\n Zadbaj o warstw\u0119 translacji b\u0142\u0119d\u00f3w. Dla klienta zwracaj zrozumia\u0142e komunikaty (np. \u201eNieprawid\u0142owy format adresu email\u201d). Tymczasem pe\u0142ny stack trace i szczeg\u00f3\u0142y techniczne loguj do systemu monitorowania (np. Sentry, Datadog) z odpowiednim poziomem dost\u0119pu. Unikaj u\u017cywania generycznego Zesp\u00f3\u0142 dowiaduje si\u0119 o b\u0142\u0119dzie od klienta. Nikt nie sprawdza log\u00f3w regularnie. Gdy pojawia si\u0119 problem, trzeba sp\u0119dzi\u0107 godziny na r\u0119cznym przegl\u0105daniu plik\u00f3w.<\/p>\n Brak monitorowania b\u0142\u0119d\u00f3w to prosta droga do utraty klient\u00f3w i pieni\u0119dzy. W przypadku SaaS czy e-commerce ka\u017cda minuta przestoju kosztuje. Bez alert\u00f3w o b\u0142\u0119dach krytycznych (np. 5xx, timeouty) reagujesz z op\u00f3\u017anieniem. Dodatkowo, bez agregacji b\u0142\u0119d\u00f3w trudno dostrzec trendy \u2013 np. \u017ce w weekendy ro\u015bnie liczba b\u0142\u0119d\u00f3w zwi\u0105zanych z p\u0142atno\u015bciami.<\/p>\n Wdr\u00f3\u017c narz\u0119dzia do monitorowania b\u0142\u0119d\u00f3w (Sentry, Rollbar, New Relic) skonfiguruj alerty o b\u0142\u0119dach krytycznych. Zasada: ka\u017cdy b\u0142\u0105d 5xx powinien by\u0107 natychmiast zg\u0142oszony. Dla b\u0142\u0119d\u00f3w biznesowych (np. p\u0142atno\u015b\u0107 odrzucona) ustaw alerty z mniejszym priorytetem, ale regularnie je przegl\u0105daj. Dodatkowo loguj metryki: czas odpowiedzi, liczb\u0119 b\u0142\u0119d\u00f3w na endpoint, statusy HTTP. To pozwoli Ci szybko wykry\u0107 problemy.<\/p>\n Error handling to nie tylko kwestia techniczna \u2013 to element strategii biznesowej. Dobrze zaprojektowana obs\u0142uga b\u0142\u0119d\u00f3w oszcz\u0119dza czas, pieni\u0105dze i buduje zaufanie. Z\u0142e podej\u015bcie generuje ukryte koszty: wi\u0119cej czasu na debugowanie, utracone zam\u00f3wienia, wy\u017csze rachunki za chmur\u0119 (bo b\u0142\u0119dy obci\u0105\u017caj\u0105 CPU i pami\u0119\u0107) oraz spadek morale zespo\u0142u.<\/p>\n Przyjrzyj si\u0119 swoim logom. Czy widzisz tam komunikaty, kt\u00f3re nic nie m\u00f3wi\u0105? Czy Twoje API wycieka szczeg\u00f3\u0142y implementacji? Czy w og\u00f3le wiesz, ile b\u0142\u0119d\u00f3w wyst\u0119puje dziennie? Je\u015bli odpowied\u017a na kt\u00f3re\u015b pytanie brzmi \u201enie\u201d, to znak, \u017ce warto zainwestowa\u0107 w porz\u0105dn\u0105 obs\u0142ug\u0119 b\u0142\u0119d\u00f3w. Jako praktyk, kt\u00f3ry zajmuje si\u0119 tym na co dzie\u0144, widz\u0119, jak wiele firm traci pieni\u0105dze przez pomijanie tego obszaru. A przecie\u017c naprawa jest prosta \u2013 wystarczy kilka poprawek w kodzie i dobre narz\u0119dzia.<\/p>\n","protected":false},"excerpt":{"rendered":" Wprowadzenie Ka\u017cdy programista pisze kod, kt\u00f3ry dzia\u0142a \u2013 do czasu, a\u017c pojawi si\u0119 b\u0142\u0105d. Wtedy zaczyna si\u0119 prawdziwy test architektury. Obs\u0142uga b\u0142\u0119d\u00f3w (error handling) to jeden z najbardziej niedocenianych aspekt\u00f3w backendu, a jego koszty s\u0105 cz\u0119sto ukryte g\u0142\u0119boko w bud\u017cetach operacyjnych. Z\u0142e podej\u015bcie do b\u0142\u0119d\u00f3w nie tylko frustruje u\u017cytkownik\u00f3w, ale generuje realne straty: wy\u017csze rachunki<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[52,556,879,92],"class_list":["post-2320","post","type-post","status-publish","format-standard","hentry","category-warto-wiedziec","tag-aplikacje-webowe","tag-architektura-backend","tag-error-handling","tag-optymalizacja-kosztow"],"_links":{"self":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2320","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/comments?post=2320"}],"version-history":[{"count":0,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/posts\/2320\/revisions"}],"wp:attachment":[{"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/media?parent=2320"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/categories?post=2320"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/news.jurskitech.pl\/blog\/wp-json\/wp\/v2\/tags?post=2320"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Error: something went wrong<\/code>. Zesp\u00f3\u0142 developer\u00f3w sp\u0119dza godziny na pr\u00f3bach odtworzenia problem\u00f3w. Klienci zg\u0142aszaj\u0105, \u017ce strona nagle przestaje dzia\u0142a\u0107, a CTO nie wie, co si\u0119 sta\u0142o. To klasyczny objaw \u0142apania wyj\u0105tk\u00f3w na zbyt niskim poziomie lub zbyt wysokim \u2013 bez kontekstu.<\/p>\nDlaczego to boli biznes<\/h3>\n
500 Internal Server Error<\/code>, u\u017cytkownik zobaczy og\u00f3lny komunikat \u2013 i zrezygnuje z zakupu. Ale je\u015bli z\u0142apiesz go zbyt nisko, np. w warstwie dost\u0119pu do danych, mo\u017cesz ukry\u0107 problem, kt\u00f3ry powinien by\u0107 widoczny (np. brak po\u0142\u0105czenia z baz\u0105). To prowadzi do utraty zam\u00f3wie\u0144 i trudniejszej diagnostyki.<\/p>\nRozwi\u0105zanie<\/h3>\n
OutOfStockError<\/code> w logice biznesowej, a w kontrolerze \u0142ap go i zwr\u00f3\u0107 odpowiedni kod HTTP (np. 409 Conflict) z komunikatem \u201eProdukt niedost\u0119pny\u201d. Inne b\u0142\u0119dy, jak DatabaseConnectionError<\/code>, powinny by\u0107 logowane i zwraca\u0107 503. Dzi\u0119ki temu frontend mo\u017ce odpowiednio zareagowa\u0107, a Ty wiesz, co si\u0119 dzieje.<\/p>\nB\u0142\u0105d 2: Zbyt szczeg\u00f3\u0142owe komunikaty b\u0142\u0119d\u00f3w w API<\/h2>\n
Objawy<\/h3>\n
{ \"error\": \"Invalid email format: user@.com\" }<\/code> lub gorzej \u2013 { \"error\": \"SQL error: Column 'email' cannot be null\" }<\/code>. To cz\u0119sty widok w aplikacjach, kt\u00f3re nie odfiltrowuj\u0105 informacji o wewn\u0119trznej strukturze.<\/p>\nDlaczego to boli biznes<\/h3>\n
Rozwi\u0105zanie<\/h3>\n
{ \"error\": true }<\/code> \u2013 to te\u017c frustruje. <\/p>\nB\u0142\u0105d 3: Brak obserwowalno\u015bci b\u0142\u0119d\u00f3w<\/h2>\n
Objawy<\/h3>\n
Dlaczego to boli biznes<\/h3>\n
Rozwi\u0105zanie<\/h3>\n
Podsumowanie<\/h2>\n