@@ -4,6 +4,9 @@ title: Network Errors
44
55import { Aside } from " @astrojs/starlight/components" ;
66
7+ export const Yes = () => <svg xmlns = " http://www.w3.org/2000/svg" width = " 20" height = " 20" viewBox = " 0 0 24 24" fill = " none" stroke = " #22c55e" strokeWidth = " 2.5" strokeLinecap = " round" strokeLinejoin = " round" aria-label = " Yes" ><polyline points = " 20 6 9 17 4 12" /></svg >;
8+ export const No = () => <svg xmlns = " http://www.w3.org/2000/svg" width = " 20" height = " 20" viewBox = " 0 0 24 24" fill = " none" stroke = " #ef4444" strokeWidth = " 2.5" strokeLinecap = " round" strokeLinejoin = " round" aria-label = " No" ><line x1 = " 18" y1 = " 6" x2 = " 6" y2 = " 18" /><line x1 = " 6" y1 = " 6" x2 = " 18" y2 = " 18" /></svg >;
9+
710If you run lychee and some links fail, it could be a transient network issue or
811a certificate-related problem. Certificates are used to verify the identity of a
912website and to establish a secure connection. Different operating systems and
@@ -35,23 +38,23 @@ transient and may succeed on a second attempt.
3538
3639The table below summarises which error types trigger a retry:
3740
38- | Error Type | Retried? | Examples |
39- | ------------------------------- | -------- | --------------------------------------------- |
40- | 5xx Server Errors | ✅ Yes | 500, 502, 503, 504 |
41- | 408 Request Timeout | ✅ Yes | Request took too long |
42- | 429 Too Many Requests | ✅ Yes | Rate limit exceeded |
43- | Connection Timeout | ✅ Yes | Server didn't respond in time |
44- | Connection Reset | ✅ Yes | Connection dropped unexpectedly |
45- | Connection Aborted | ✅ Yes | Connection terminated mid-request |
46- | Incomplete Message | ✅ Yes | Response cut off before completion |
47- | 4xx Client Errors | ❌ No | 400, 401, 403, 404 (except 408, 429) |
48- | 2xx Success | ❌ No | 200, 201, 204 |
49- | 3xx Redirects | ❌ No | 301, 302 |
50- | Initial Connection Failure | ❌ No | Can't reach server at all |
51- | Certificate Issues | ❌ No | SSL/TLS errors |
52- | Invalid Request Body | ❌ No | Malformed data |
53- | Decoding Errors | ❌ No | Can't parse response |
54- | Redirect Errors | ❌ No | Too many redirects, etc. |
41+ | Error Type | Retried? | Examples |
42+ | ------------------------------- | -------------- | --------------------------------------------- |
43+ | 5xx Server Errors | < Yes /> | 500, 502, 503, 504 |
44+ | 408 Request Timeout | < Yes /> | Request took too long |
45+ | 429 Too Many Requests | < Yes /> | Rate limit exceeded |
46+ | Connection Timeout | < Yes /> | Server didn't respond in time |
47+ | Connection Reset | < Yes /> | Connection dropped unexpectedly |
48+ | Connection Aborted | < Yes /> | Connection terminated mid-request |
49+ | Incomplete Message | < Yes /> | Response cut off before completion |
50+ | 4xx Client Errors | < No /> | 400, 401, 403, 404 (except 408, 429) |
51+ | 2xx Success | < No /> | 200, 201, 204 |
52+ | 3xx Redirects | < No /> | 301, 302 |
53+ | Initial Connection Failure | < No /> | Can't reach server at all |
54+ | Certificate Issues | < No /> | SSL/TLS errors |
55+ | Invalid Request Body | < No /> | Malformed data |
56+ | Decoding Errors | < No /> | Can't parse response |
57+ | Redirect Errors | < No /> | Too many redirects, etc. |
5558
5659** As a rule of thumb:**
5760- ** Retries:** Temporary problems (server down, network hiccup, timeout)
0 commit comments