חיבור WebSocket נכשל: איך בודקים ומה שגיאה 1006 אומרת

כשדפדפן אומר שחיבור WebSocket נכשל, הסיבה כמעט תמיד אחת מכמה: פרוקסי שלא מעביר WebSocket, לחיצת יד שהשרת דחה, בעיה בתעודה, או חיבור שנחתך כי נראה לא פעיל. כדי לדעת איזו, התחברו לאותה כתובת עם בדיקת WebSocket שלנו, קראו את קוד הסגירה, ואז בדקו את לחיצת היד.
הפוסט הזה עובר על הצעדים האלה, ועל התיקון לכל סיבה.
למה הדפדפן מספר לכם כל כך מעט
הקוד שלכם מקבל אירוע error בלי פרטים, ואחריו סגירה עם קוד 1006. שרת לעולם לא שולח את הקוד הזה. RFC 6455 שומר אותו כדי שצד אחד יוכל לדווח על חיבור שהסתיים בלי הודעת סגירה, ולכן הוא אומר רק שמשהו השתבש.
העמימות נעשית בכוונה. אם דף היה יכול להבדיל בין לחיצת יד שנדחתה לפורט סגור, סקריפט היה יכול להשתמש בזה כדי לסרוק את הרשת של המבקר. לכן הפרטים מוסתרים מהקוד שלכם, וצריך לחפש במקום אחר:
- כלי המפתחים של הדפדפן. בלוח Network סננו לפי WS ובחרו את החיבור. הוא מראה את הסטטוס של לחיצת היד ואת כל ההודעות.
- הקונסולה. הדפדפן רושם שם סיבה שהקוד שלכם לא יכול לקרוא.
- היומנים של השרת ושל הפרוקסי, שרואים את מה שהדפדפן מסתיר.
צעד 1: בודקים את הכתובת
פתחו את בדיקת WebSocket, הזינו את כתובת ה-wss:// והתחברו. היא רושמת כמה זמן לקח החיבור, כל הודעה בשני הכיוונים, ואת קוד הסגירה עם משמעותו.
אם היא מתחברת כאן ולא באפליקציה שלכם, השוו בין השניים. לבדיקה הזאת יש origin משלה ואין לה אף אחד מהטוקנים של האפליקציה שלכם, ולכן ההבדל הוא בדרך כלל אימות או בדיקה של ה-origin. אם גם כאן היא נכשלת, נסו מרשת אחרת, כמו נקודה חמה של טלפון, כדי לשלול VPN או פרוקסי של חברה.
צעד 2: בודקים את לחיצת היד
WebSocket מתחיל כבקשת HTTP, ו-curl מראה את התשובה שהדפדפן מסתיר:
curl -i -N --http1.1 \
-H "Connection: Upgrade" \
-H "Upgrade: websocket" \
-H "Sec-WebSocket-Version: 13" \
-H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
https://example.com/socketהוסיפו -H "Origin: https://your-site.example" אם השרת שלכם בודק מאיפה מגיע חיבור. השורה הראשונה של התשובה אומרת את רוב הדברים:
101 Switching Protocols. לחיצת היד עובדת, ולכן הסתכלו על מה שקורה אחריה.200. הבקשה הגיעה לדף רגיל, ולכן הפרוקסי לא מעביר אותה כ-WebSocket, או שהנתיב שגוי.400. השרת לא קיבל את לחיצת היד. יש שרתים שגם מצפים ליותר מבקשה כמו זו.401או403. האימות נכשל, או שה-origin לא מורשה.404. שום דבר לא מאזין בנתיב הזה.502,503או504. הפרוקסי לא יכול להגיע לשרת שמאחוריו.
אם curl מדווח על שגיאת תעודה, מצאתם את הסיבה: דפדפן דוחה את החיבור באותה דרך, ומראה לקוד שלכם את אותו 1006.
הסיבות הרגילות והתיקונים שלהן
הפרוקסי לא מעביר WebSocket. זו הסיבה הנפוצה ביותר. פרוקסי צריך להעביר את כותרות ה-upgrade בכוונה, וב-nginx זה נראה כך:
location /socket {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 3600s;
}הוא נופל אחרי בערך דקה. פרוקסי ומאזני עומסים סוגרים חיבורים שנראים לא פעילים, וה-proxy_read_timeout של nginx הוא 60 שניות אלא אם משנים אותו. העלאתו עוזרת, אבל שלחו הודעה קטנה או ping בתדירות גבוהה מה-timeout הקצר ביותר בדרך, כי אין לכם שליטה בכל פרוקסי שבינכם לבין המשתמשים.
ws:// מדף HTTPS. דפדפנים חוסמים את זה כתוכן מעורב, פרט ל-ws:// אל localhost. השתמשו ב-wss:// בדף שמוגש ב-HTTPS.
ה-origin נדחה. שרתים מתירים לעיתים קרובות חיבורים רק מהאתרים שלהם, ודוחים את השאר בלחיצת היד. הוסיפו את כתובת האתר שלכם לרשימה.
אין דרך לשלוח כותרות. אף דפדפן לא יכול להגדיר כותרות ב-WebSocket, ולכן טוקן בכותרת Authorization אף פעם לא מגיע. שלחו אותו במחרוזת השאילתה, כ-subprotocol, או בהודעה הראשונה.
הוא נכשל בכל פריסה. הפעלה מחדש מפילה כל חיבור. התחברו מחדש עם השהיה שגדלה ואקראית כדי שכולם לא יחזרו בבת אחת, ואל תניחו שדבר לא הוחמץ בזמן ההיעדרות.
מה קודי הסגירה אומרים
אחרי שחיבור נפתח, שווה לקרוא את הקוד שאיתו הוא נסגר:
- 1000: סגירה רגילה, בכוונה.
- 1001: עזיבה, כמו שרת שנסגר או דף שעזבו.
- 1006: אין הודעת סגירה, כמו למעלה.
- 1008: השרת סירב לפי הכללים שלו, לרוב אימות או ה-origin.
- 1011: משהו השתבש בשרת.
- 1012 ו-1013: הפעלה מחדש, או לנסות שוב מאוחר יותר.
בדיקת WebSocket מפרטת את כולם עם משמעותם. קודים מ-4000 ומעלה שייכים לשרת או לספרייה שלו.
אם אתם מעדיפים לא להריץ את השרת
רוב זה נובע מהרצת websockets בעצמכם: הפרוקסי, ה-timeouts, ההפעלות מחדש. Websockets ב-Python וב-Laravel עוברים על מה שזה דורש בכל פריימוורק, ולמה אחסון WordPress לא יכול להחזיק websocket מכסה אחסון משותף.
עם WordPlus Cloud, האפליקציה שלכם מתחברת לשרתי הזמן-אמת שלנו דרך ה-SDK שלנו, עם חדרים, נוכחות וחיבור מחדש, ואתם לא מריצים שרת WebSocket. המחיר נקבע לפי חיבורים, החל מ-1,000, ולתיעוד יש מדריך לכל סטאק. אם חיבור אליו נכשל, בדיקת חיבור מראה אם הרשת הזאת מגיעה לשרתים שלנו.