curl ایرر کوڈز: مکمل حوالہ

فوری حوالہ جات کی جدول

ایرر 6: ہوسٹ ریزولو نہیں ہو سکا

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (6) Could not resolve host دکھاتا ہے۔ curl ہوسٹ نیم کو IP ایڈریس میں ریزولو نہیں کر سکا — DNS لک اپ کسی بھی کنکشن کی کوشش سے پہلے ناکام ہو گئی۔

وجوہات

سب سے عام وجوہات یہ ہیں: ہوسٹ نیم میں ٹائپو (مثلاً curl https://apiexample.com بجائے api.example.com)، DNS سرور کے مسائل (آپ کا مقرر DNS بند یا ناقابل رسائی ہے)، نیٹ ورک کنکشن نہیں (Wi-Fi منقطع، VPN نہیں جڑا)، یا ڈومین واقعی موجود نہیں۔

حل کیسے کریں

پہلے، تصدیق کریں کہ URL درست ہے۔ پھر DNS ریزولوشن کو براہ راست جانچیں: nslookup api.example.com یا dig api.example.com۔ اگر DNS ناکام ہو جائے، تو مختلف DNS سرور آزمائیں: curl --dns-servers 8.8.8.8 https://api.example.com۔ اپنا /etc/resolv.conf یا نیٹ ورک سیٹنگز چیک کریں۔ اگر کارپوریٹ VPN کے پیچھے ہیں، تو یقینی بنائیں کہ اندرونی DNS ہوسٹ کو ریزولو کر سکتا ہے۔

$ curl https://api.exmple.com/users

ایرر 7: کنکشن ناکام

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (7) Failed to connect to host port: Connection refused دکھاتا ہے۔ curl نے ہوسٹ نیم ریزولو کر لیا لیکن سرور سے TCP کنکشن قائم نہیں کر سکا — کنکشن فعال طور پر مسترد ہو گیا یا TCP سطح پر ٹائم آؤٹ ہو گیا۔

وجوہات

عام وجوہات میں شامل ہیں: سرور بند ہے یا نہیں چل رہا، فائروال پورٹ بلاک کر رہی ہے (مقامی اور سرور سائیڈ دونوں فائروالز چیک کریں)، پورٹ غلط ہے (مثلاً سروس 8080 پر چلتی ہے لیکن آپ 443 سے جڑ رہے ہیں)، یا سرور کا لسن بیک لاگ بھر گیا ہے زیادہ بوجھ کے تحت۔

حل کیسے کریں

تصدیق کریں کہ سرور چل رہا ہے: ping api.example.com اور telnet api.example.com 443۔ چیک کریں کہ صحیح پورٹ کھلا ہے: nmap -p 443 api.example.com۔ جانچ کے لیے مقامی فائروال عارضی طور پر غیر فعال کریں۔ اگر Docker استعمال کر رہے ہیں، تو یقینی بنائیں کنٹینر پورٹ شائع ہے۔ وربوز موڈ سے آزمائیں: curl -v https://api.example.com تاکہ دیکھ سکیں کنکشن بالکل کہاں ناکام ہوتا ہے۔

$ curl https://localhost:8080/api

ایرر 22: HTTP نے ایرر واپس کیا

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (22) The requested URL returned error دکھاتا ہے۔ سرور نے HTTP ایرر اسٹیٹس کوڈ (4xx یا 5xx) واپس کیا اور curl کو -f یا --fail کے ساتھ چلایا گیا تھا، جو curl کو HTTP ایررز کو ناکامی سمجھنے کا حکم دیتا ہے۔

وجوہات

ایرر HTTP اسٹیٹس کوڈز جیسے 400 (Bad Request)، 401 (Unauthorized)، 403 (Forbidden)، 404 (Not Found)، یا 500 (Internal Server Error) سے پیدا ہوتی ہے — لیکن صرف جب --fail استعمال ہو۔ --fail کے بغیر، curl HTTP ایررز پر بھی کوڈ 0 سے باہر نکلتا ہے۔ عام وجوہات: غلط URL، گم شدہ تصدیق، ناکافی اجازتیں، یا سرور سائیڈ بگز۔

حل کیسے کریں

مکمل جوابی باڈی دیکھنے کے لیے --fail کے بغیر curl چلائیں — اس میں اکثر اصل ایرر پیغام ہوتا ہے۔ HTTP اسٹیٹس کوڈ چیک کریں: curl -w "%{http_code}" -o /dev/null -s URL۔ 401/403 کے لیے: اپنا auth ٹوکن یا API کلید تصدیق کریں۔ 404 کے لیے: URL پاتھ دوبارہ چیک کریں۔ 500 کے لیے: مسئلہ سرور سائیڈ ہے۔

$ curl --fail https://api.example.com/nonexistent

ایرر 28: آپریشن ٹائم آؤٹ ہو گیا

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (28) Operation timed out یا curl: (28) Connection timed out دکھاتا ہے۔ آپریشن مقررہ وقت سے زیادہ لے گیا۔ یہ سب سے عام curl ایرر ہے — یہ DNS ریزولوشن، TCP کنکشن، SSL ہینڈ شیک، یا ڈیٹا ٹرانسفر کے دوران ہو سکتی ہے۔

وجوہات

عام وجوہات میں شامل ہیں: سست یا اوورلوڈ سرور وقت پر جواب نہیں دے رہا، نیٹ ورک کی بھیڑ یا پیکٹ لاس، فائروال خاموشی سے پیکٹ گرا رہی ہے (مسترد نہیں، صرف خاموشی)، --connect-timeout یا --max-time سے سیٹ کیے گئے بہت سخت ٹائم آؤٹ ویلیوز، یا تاخیر کا سبب بننے والی پراکسی کی غلط ترتیب۔

حل کیسے کریں

ٹائم آؤٹ بڑھائیں: curl --connect-timeout 30 --max-time 120 URL۔ وربوز موڈ استعمال کریں یہ دیکھنے کے لیے کہ کہاں اٹکا ہوا ہے: curl -v URL۔ نیٹ ورک لیٹنسی جانچیں: ping api.example.com اور traceroute api.example.com۔ اگر پراکسی کے پیچھے ہیں، تو اسے بائی پاس کرنے کی کوشش کریں: curl --noproxy '*' URL۔ بڑی فائل ٹرانسفرز کے لیے، --retry 3 کے ساتھ --retry-delay 5 استعمال کرنے پر غور کریں۔

$ curl --connect-timeout 5 https://slow-api.example.com/data

ایرر 35: SSL کنکشن ایرر

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (35) SSL connect error دکھاتا ہے۔ SSL/TLS ہینڈ شیک ناکام ہوا — curl سرور کے ساتھ محفوظ کنکشن قائم نہیں کر سکا۔

وجوہات

عام وجوہات: TLS ورژن کی عدم مطابقت (سرور TLS 1.3 چاہتا ہے لیکن آپ کا curl صرف TLS 1.2 تک کی حمایت کرتا ہے)، سائفر سوئٹ کی عدم مطابقت، سرور SSL کی غلط ترتیب (ہینڈ شیک کے دوران میعاد ختم شدہ سرٹیفکیٹ، نامکمل چین)، سرور مقررہ پورٹ پر دراصل HTTPS کی حمایت نہیں کرتا، یا کوئی پراکسی یا فائروال SSL کنکشن میں مداخلت کر رہی ہے (MITM)۔

حل کیسے کریں

مخصوص TLS ورژن کو مجبور کریں: curl --tlsv1.2 URL یا curl --tlsv1.3 URL۔ چیک کریں سرور کیا حمایت کرتا ہے: openssl s_client -connect api.example.com:443۔ curl اور OpenSSL کو تازہ ترین ورژن میں اپ ڈیٹ کریں۔ اگر سرور self-signed سرٹیفکیٹ استعمال کرتا ہے، تو یہ عام طور پر ایرر 60 ہوتی ہے — ایرر 35 عام طور پر پروٹوکول سطح کی ہینڈ شیک ناکامی کی نشاندہی کرتی ہے۔

$ curl https://legacy-server.example.com/api

ایرر 56: وصولی ناکام — کنکشن ری سیٹ ہو گیا

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (56) Recv failure: Connection reset by peer دکھاتا ہے۔ کنکشن کامیابی سے قائم ہوا، لیکن ڈیٹا کی وصولی ناکام ہوئی — سرور نے ٹرانسفر کے دوران غیر متوقع طور پر کنکشن بند یا ری سیٹ کر دیا۔

وجوہات

یہ اکثر اس وقت ہوتا ہے جب: سرور ٹرانسفر کے دوران کریش یا ری اسٹارٹ ہو جائے، لوڈ بیلنسر یا پراکسی کنکشن ختم کر دے (بے عمل ٹائم آؤٹ، درخواست بہت بڑی)، فائروال طویل عرصے کے کنکشنز ختم کر دے، سرور کا keep-alive ٹائم آؤٹ متوقع سے کم ہو، یا کلائنٹ اور سرور کے درمیان نیٹ ورک میں خلل آ جائے۔

حل کیسے کریں

درخواست دوبارہ کوشش کریں — عارضی نیٹ ورک مسائل سب سے عام وجہ ہیں۔ ناکامی کا صحیح مقام دیکھنے کے لیے وربوز موڈ استعمال کریں: curl -v URL۔ اگر بڑے اپ لوڈز کے دوران ایرر آئے، تو چنکڈ ٹرانسفر آزمائیں: curl -H "Transfer-Encoding: chunked" URL۔ Git آپریشنز میں RPC failed; curl 56 دکھنے پر، بفر بڑھائیں: git config http.postBuffer 524288000۔

$ curl https://api.example.com/large-download

ایرر 60: SSL سرٹیفکیٹ کا مسئلہ

اس کا مطلب کیا ہے

آپ کا ٹرمینل curl: (60) SSL certificate problem: unable to get local issuer certificate دکھاتا ہے۔ curl سرور کے SSL سرٹیفکیٹ کو اپنے CA (سرٹیفکیٹ اتھارٹی) بنڈل سے تصدیق نہیں کر سکا۔ TLS ہینڈ شیک پروٹوکول سطح پر مکمل ہوا، لیکن سرٹیفکیٹ کی توثیق ناکام ہوئی۔

وجوہات

سب سے عام وجوہات: سرور self-signed سرٹیفکیٹ استعمال کرتا ہے، سرٹیفکیٹ کی میعاد ختم ہو چکی ہے، سرٹیفکیٹ چین نامکمل ہے (انٹرمیڈیٹ سرٹیفکیٹس غائب)، curl کا CA بنڈل پرانا ہے (پرانے سسٹمز یا Docker کنٹینرز میں عام)، یا سرٹیفکیٹ کا Common Name / SAN درخواست کردہ ہوسٹ نیم سے میل نہیں کھاتا۔

حل کیسے کریں

CA بنڈل اپ ڈیٹ کریں: curl --cacert /path/to/cacert.pem URL۔ https://curl.se/ca/cacert.pem سے اپ ڈیٹ شدہ بنڈل ڈاؤن لوڈ کریں۔ تشخیص کے لیے: openssl s_client -connect api.example.com:443 -showcerts۔ ڈیولپمنٹ میں self-signed سرٹیفکیٹس کے لیے، curl -k URL استعمال کریں (پروڈکشن میں کبھی نہیں — یہ تمام سرٹیفکیٹ تصدیق غیر فعال کر دیتا ہے)۔ Docker میں ca-certificates پیکج انسٹال کریں۔

$ curl https://self-signed.example.com/api

دیگر ایرر کوڈز

curl ایررز کو کیسے ڈیبگ کریں

جب curl ناکام ہو جائے، تو یہ تین فلیگز آپ کو بنیادی وجہ تیزی سے شناخت کرنے میں مدد کرتے ہیں — DNS ریزولوشن سے لے کر SSL ہینڈ شیک سے لے کر ریسپانس پے لوڈ تک۔

1. 1

   وربوز آؤٹ پٹ فعال کریں

   مکمل درخواست/جواب سائیکل دیکھنے کے لیے curl -v URL چلائیں: DNS ریزولوشن، TCP کنکشن، TLS ہینڈ شیک، بھیجے گئے درخواست ہیڈرز، اور موصول شدہ جوابی ہیڈرز۔ یہ واحد سب سے مفید ڈیبگنگ فلیگ ہے۔

2. 2

   HTTP اسٹیٹس کوڈ چیک کریں

   جوابی باڈی کے بغیر صرف HTTP اسٹیٹس کوڈ (200، 404، 500 وغیرہ) حاصل کرنے کے لیے curl -o /dev/null -s -w "%{http_code}" URL چلائیں۔ فوری ہیلتھ چیکس اور اسکرپٹنگ کے لیے مفید ہے۔

3. 3

   خاموشی سے ایررز دکھائیں

   پروگریس بار چھپانے (-s) لیکن پھر بھی ایررز دکھانے (-S) کے لیے curl -sS URL چلائیں۔ اسکرپٹس کے لیے بہترین جہاں آپ صاف آؤٹ پٹ چاہتے ہیں لیکن ناکامیاں پکڑنا ضروری ہے۔

اکثر پوچھے جانے والے سوالات