Retry Conditions — Qaysi xatolarda request qayta yuborilishini aniqlash
Axios so'rovlarini qayta yuborish shartlari (Retry Conditions): Retryable xatolar (Tarmoq, Timeout, 5xx, 429), Non-retryable xatolar (4xx, 401, ERR_CANCELED) va shouldRetryRequest funksiyasi.
72-dars
Retry Conditions — Qaysi xatolarda request qayta yuborilishini aniqlash
Agar siz barcha xatoliklarda (shu jumladan forma validatsiyasi yoki ruxsat yo'qligi xatolarida ham) so'rovni ko'r-ko'rona qayta yuboraversangiz, bu serverni yanada ortiqcha zo'riqtirib qo'yishi yoki ma'lumotlar bazasida kutilmagan nomutanosibliklarni keltirib chiqarishi mumkin.
Professional arxitekturada Retry Conditions (Qayta urinish shartlari) filtri faqatgina vaqtinchalik va o'z-o'zidan qayta tiklanishi mumkin bo'lgan texnik nosozliklarnigina tanlab oladi.
1. Qaysi xatolarda so'rovni QAYTA YUBORISH KERAK? (Retryable Errors)
Bu guruhga faqat tashqi muhit va infratuzilmaning vaqtinchalik (transient) muammolari kiradi. Ularda so'rovning o'zi to'g'ri shakllantirilgan, lekin ayni damdagi nosozlik sababli server javob bera olmagan:
- Tarmoq xatolari (Network Errors):
!error.response— So'rov serverga umuman yetib bormagan yoki internet uzilgan.error.code === 'ERR_NETWORK'— Tarmoq bilan aloqa uzilgan.
- Timeout xatolari:
error.code === 'ECONNABORTED'— Server o'sha soniyada juda band bo'lgani uchun javob berish vaqti cho'zilib ketdi.
- Serverning ichki nosozliklari (5xx Status Codes):
500 Internal Server Error— Ba'zan server qisqa muddatli mikroyuklamada qulab, darhol qayta ishga tushishi mumkin.502 Bad Gateway,503 Service Unavailable,504 Gateway Timeout— Serverda rejali qayta yuklash yoki texnik ishlar ketmoqda.
- 429 Too Many Requests (Shartli ravishda):
- Agar so'rovlar soni me'yordan oshgani uchun server vaqtincha to'xtatgan bo'lsa va javob sarlavhasida
Retry-Aftervaqti ko'rsatilgan bo'lsa.
- Agar so'rovlar soni me'yordan oshgani uchun server vaqtincha to'xtatgan bo'lsa va javob sarlavhasida
2. Qaysi xatolarda so'rovni QAYTA YUBORISH MAN ETILADI? (Non-retryable Errors)
Bu guruhga dasturiy, mantiqiy yoki mijoz tomondagi xatolar kiradi. Ularni ming marta qayta yuborsangiz ham baribir o'sha xato chiqaveradi:
- Client Error statuslari (4xx):
400 Bad Request— Yuborilgan JSON yoki ma'lumotlar strukturasi noto'g'ri.403 Forbidden— Foydalanuvchida bu amalni bajarishga huquq yo'q. Qayta yuborish bilan yangi huquq paydo bo'lib qolmaydi.404 Not Found— So'ralgan resurs bazada yo'q.422 Unprocessable Entity— Validatsiya xatosi (masalan, kiritilgan parol talabga javob bermaydi).
- 401 Unauthorized (Muhim istisno):
401xatosida so'rov to'g'ridan-to'g'ri retry qilinmaydi! Buning o'rniga avval Token Refresh mexanizmi ishga tushiriladi va faqat yangi token olingach, so'rov takrorlanadi.
- Bekor qilingan so'rovlar:
error.code === 'ERR_CANCELED'— Foydalanuvchi yokiAbortControllerataylab to'xtatgan so'rovni qayta yuborish mutlaqo noto'g'ri.
3. Amaliyot: TypeScript'da shouldRetryRequest funksiyasini yozish
axios-retry yoki custom interceptor uchun qat'iy va xavfsiz shartlar tekshiruvchisi:
// src/api/shouldRetryRequest.ts
import { AxiosError } from 'axios';
export const shouldRetryRequest = (error: AxiosError): boolean => {
// 1. Agar foydalanuvchi yoki komponent so'rovni o'zi bekor qilgan bo'lsa -> QAYTA URINMA!
if (error.code === 'ERR_CANCELED') {
return false;
}
// 2. Tarmoq uzilishi yoki Timeout bo'lsa -> Qayta urinish MUMKIN
const isNetworkOrTimeout = !error.response || error.code === 'ECONNABORTED';
if (isNetworkOrTimeout) {
return true;
}
// 3. Server javob qaytargan bo'lsa, HTTP status kodini tekshiramiz
if (error.response) {
const status = error.response.status;
// 5xx (Server xatolari: 500, 502, 503, 504) -> Qayta urinish MUMKIN
if (status >= 500 && status < 600) {
return true;
}
// 401 (Unauthorized) -> Buni alohida Token Refresh interceptor hal qiladi
if (status === 401) {
return false;
}
// Barcha boshqa 4xx (400, 403, 404, 422) xatolar -> QAYTA URINMA!
if (status >= 400 && status < 500) {
return false;
}
}
// Qolgan barcha kutilmagan holatlarda sukut bo'yicha qayta urinmaymiz
return false;
};
4. axios-retry kutubxonasiga ulash
Yuqoridagi filtr funksiyasini asosiy API client sozlamalariga ulash:
// src/api/client.ts
import axios, { AxiosError } from 'axios';
import axiosRetry from 'axios-retry';
import { shouldRetryRequest } from './shouldRetryRequest';
export const apiClient = axios.create({
baseURL: 'https://api.mysite.com/v1',
timeout: 10000,
});
axiosRetry(apiClient, {
retries: 3,
retryDelay: axiosRetry.exponentialDelay, // Eksponensial kechikish
retryCondition: (error) => {
// Biz yozgan qat'iy shart funksiyasini ulaymiz:
return shouldRetryRequest(error as AxiosError);
},
});
5. Retryable vs Non-retryable Xatolar Jadvali
| Xatolik turi | Status / Kod | Retry harakati | Sababi |
|---|---|---|---|
| Tarmoq uzilishi | ERR_NETWORK |
Qayta urinish (Retry) | Aloqa 1 soniyadan so'ng qayta tiklanishi mumkin |
| Timeout | ECONNABORTED |
Qayta urinish (Retry) | Server mikroyuklamasi o'tib ketgan bo'lishi mumkin |
| Server Error | 500, 502, 503, 504 |
Qayta urinish (Retry) | Vaqtinchalik infratuzilma nosozligi |
| Canceled | ERR_CANCELED |
Qat'iyan man etiladi | Foydalanuvchi yoki sahifa unmount tufayli ataylab to'xtatilgan |
| Bad Request | 400, 422 |
Qat'iyan man etiladi | Yuborilgan parametrlar xato, qayta yuborish baribir xato beradi |
| Forbidden / 404 | 403, 404 |
Qat'iyan man etiladi | Resurs yoki ruxsat yo'q |
| Unauthorized | 401 |
Maxsus: Token Refresh | So'rov qayta emas, yangi token olingach takrorlanadi |
Xulosa
Retry Conditions — bu xatolarni saralovchi filtrdir. Qayta urinishlarni faqat haqiqiy vaqtinchalik xatolar (ERR_NETWORK, ECONNABORTED, 5xx) bilan cheklash orqali serverni ortiqcha yuklamadan himoya qilish va dastur barqarorligini ta'minlash mumkin.