7.1.1.關閉WebSocket連接

7.1.定義

7.1.1.關閉WebSocket連接

為_關閉WebSocket連接_，端點需關閉底層TCP連接。端點應該使用一個方法完全地關閉TCP連接，以及TLS會話，如果合適，丟棄任何可能已經接收的尾隨的字節。當必要時端點可以通過任何可用的手段關閉連接，例如當受到攻擊時。

底層TCP連接，在大多數正常情況下，應該首先被服務器關閉，所以它持有TIME_WAIT狀態而不是客戶端（因為這會防止它在2個報文最大生存時間（2MLS）內重新打開連接，然而當一個新的帶有更高的seq number的SYN時沒有對應的服務器影響TIME_WAIT連接被立即重新打開）。在異常情況下（例如在一個合理的時間量后沒有接收到服務器的TCP Close）客戶端可以發起TCP Close。因此，當服務器被指示_關閉WebSocket連接_，它應該立即發起一個TCP Close，且當客戶端被知識也這么做時，它應該等待服務器的一個TCP Close。

例如一個如何使用Berkeley socket在C中得到完全地關閉的例子，一端會在socket上以SHUT_WR調用shutdown()，調用recv()直到獲得一個指示那個節點也已經執行了一個有序關閉的0返回值，且最終在socket上調用close()方法。

7.1.2.啟動WebSocket關閉階段握手

為了_啟動WebSocket關閉階段握手_，其帶有一個狀態碼（7.4節）/code/和一個可選的關閉原因（7.1.6節）/reason/，一個端點必須按照5.5.1節的描述發送一個Close控制幀，其狀態碼設置為/code/且其關閉原因設置為/reason/。一旦一個端點已經發送並接收到一個Close控制幀，那個端點應該按照7.1.1節的描述_關閉WebSocket連接_。

7.1.3. WebSocket關閉階段握手已啟動

一旦發送或接收到一個Close控制幀，這就是說，_WebSocket 關閉階段握手已啟動_，且WebSocket連接處於CLOSING狀態。

7.1.4. WebSocket已關閉

當底層TCP連接已關閉，這就是說_WebSocket連接已關閉_且WebSocket連接處於CLOSED狀態。如果TCP連接在WebSocket關閉階段我是已經完成后被關閉，WebSocket連接被說成已經_完全地_關閉了。 如果WebSocket連接不能被建立，這就是說，_WebSocket連接關閉了_，但不是_完全的_。

7.1.5.WebSocket連接關閉代碼

按照5.5.1和7.4節的定義，一個Close控制幀可以包含一個表示關閉原因的狀態碼。一個正關閉的WebSocket連接可以同時由兩個端點初始化。_WebSocket連接Close Code_定義為包含在由實現該協議的應用接收到的第一個Close控制幀的狀態碼（7.4節）。如果這個Close控制幀不包含狀態碼，_WebSocket連接Close Code_被認為是1005。如果_WebSocket連接已經關閉_且端點沒有接收到Close狀態碼（例如可能發生在底層傳輸連接丟失時），_WebSocket連接Close Code_被認為是1006。

注意：兩個端點可以有不一致的_WebSocket連接關閉代碼_。例如，如果遠程端點發送了一個Close幀，但本地應用還沒有從它的socket接收緩沖區中讀到包含Close幀的數據，且本地應用獨立地決定關閉連接和發送一個Close幀，兩個端點都將發送和接收Close幀且將不發送更多的Close幀。每一個端點將看見另一端發送的以_WebSocket連接關閉代碼_結束的狀態碼。例如，在兩個端點獨立且在大致相同的時間同時_開啟WebSocket關閉階段握手_的情況下，兩個端點可以有不一致的_WebSocket連接關閉代碼_是可能的。

7.1.6. WebSocket連接關閉原因

按照5.5.1和7.4節的定義，一個控Close控制幀可以包含一個指示關閉原因的狀態碼，接着是UTF-8編碼的數據，上述數據留給斷點解釋且本協議沒有定義。WebSocket連接的關閉可以被任何一個端點初始化，可能同時發生。_WebSocket 連接關閉原因_由跟在包含在實現該協議的應用接收到的第一個Close控制幀狀態碼（7.4節）后邊的UTF-8編碼的數據定義。如果Close控制幀中沒有這樣的數據，_WebSocket連接關閉原因_是空字符串。

注意：按照7.1.5節指出的相同的邏輯，兩個端點可以有不一致的_WebSocket連接關閉原因_。

7.1.7.失敗WebSocket連接

某些算法和規范要求端點_失敗WebSocket連接_。要做到這一點，客戶端必須_關閉WebSocket連接_，並可以以適當的方式把問題報告給用戶（這將對開發人員非常有用的）。

同樣的，為了做到這一點，服務器必須_關閉WebSocket連接_，並應該記錄下問題。

如果_已建立的WebSocket連接_在端點需要_失敗WebsSocket連接_之前，端點應該在處理_關閉WebSocket連接_之前發送一個帶有適當狀態碼的Close幀（7.4節）。

如果端點認為另一邊不太可能收到並處理關閉幀可以省略發送一個關閉幀，因為錯誤的性質，導致WebSocket連接失敗擺在首要位置。端點必須在被指示為_失敗WebSocket端點_之后不繼續嘗試處理來自遠程端點的數據（包括響應關閉幀）。

除上邊指出的或由應用層指定的（例如，使用WebSocket API的腳本），客戶端應該關閉連接。

7.2.異常關閉

7.2.1.客戶端發起的關閉

某些算法，尤其在打開階段握手期間，需要客戶端_失敗WebSocket連接_。為了做到這一點，客戶端必須按照7.1.7節定義的那樣_失敗WebSocket連接_。

如果在任何時候，底層的傳輸層連接意外丟失，客戶端必須_失敗WebSocket連接_。 除上邊指出的或由應用層指定的（例如，使用WebSocket API的腳本），客戶端應該關閉連接。

7.2.2.服務端發起的關閉

某些算法需要或推薦服務端在打開階段握手期間_中斷WebSocket連接_。為了做到這一點，服務端必須簡單地_關閉WebSocket連接_（7.1.1節）。

7.2.3.從異常關閉中恢復

異常關閉可能由任何原因引起。這樣的關閉可能是一個瞬時錯誤導致的，在這種情況下重新連接可能導致一個好的連接和一個重新開始的正常操作。這樣的關閉也可能是一個非瞬時問題的導致的，在這種情況下如果每個部署的客戶端遇到異常關閉並立即且持續地的嘗試重新連接，服務端可能會因為大量的客戶端嘗試重新連接遇到的拒絕服務攻擊。這種情況的最終結果可能是服務不能及時的恢復或恢復是更加困難。

為了避免這個，當客戶端遇到本節描述的異常關閉之后嘗試重新連接時，應該使用某種形式的補償。

第一個重新連接嘗試應該延遲一個隨機的時間量。這種隨機延遲的參數的選擇留給客戶端決定；一個可隨機選擇的的值在0到5秒是一個合理的初始延遲，不過客戶端可以選擇不同的間隔由於其選擇一個延遲長度基於實現經驗和特定的應用。

第一次重新連接嘗試失敗，隨后的重新連接嘗試應該延遲遞增的時間量，使用的方法如截斷二進制指數退避算法。

7.3.正常連接關閉

服務端在需要時可能關閉WebSocket連接。客戶端不能隨意關閉WebSocket連接。在這兩種情況下，端點通過如下過程_開始WebSocket關閉握手_初始化一個關閉（7.1.2節）。

7.4.狀態碼

當關閉一個已經建立的連接（例如，當在打開階段握手已經完成后發送一個關閉幀），端點可以表明關閉的原因。由端點解釋這個原因，並且端點應該給這個原因采取動作，本規范是沒有定義的。本規范定義了一組預定義的狀態碼，並指定哪些范圍可以被擴展、框架和最終應用使用。狀態碼和任何相關的文本消息是關閉幀的可選的組件。

7.4.1.定義的狀態碼

當發送關閉幀時端點可以使用如下預定義的狀態碼。

• 1000

  1000表示正常關閉，意思是建議的連接已經完成了。

• 1001

  1001表示端點“離開”（going away），例如服務器關閉或瀏覽器導航到其他頁面。

• 1002

  1002表示端點因為協議錯誤而終止連接。

• 1003

  1003表示端點由於它收到了不能接收的數據類型（例如，端點僅理解文本數據，但接收到了二進制消息）而終止連接。

• 1004 保留。可能在將來定義其具體的含義。

• 1005

  1005是一個保留值，且不能由端點在關閉控制幀中設置此狀態碼。它被指定用在期待一個用於表示沒有狀態碼是實際存在的狀態碼的應用中。

• 1006

  1006是一個保留值，且不能由端點在關閉控制幀中設置此狀態碼。它被指定用在期待一個用於表示連接異常關閉的狀態碼的應用中。

• 1007

  1007表示端點因為消息中接收到的數據是不符合消息類型而終止連接（比如，文本消息中存在非UTF-8[RFC3629]數據）。

• 1008

  1008表示端點因為接收到的消息違反其策略而終止連接。這是一個當沒有其他合適狀態碼（例如1003或1009）或如果需要隱藏策略的具體細節時能被返回的通用狀態碼。

• 1009

  1009表示端點因接收到的消息對它的處理來說太大而終止連接。

• 1010

  1010表示端點（客戶端）因為它期望服務器協商一個或多個擴展，但服務器沒有在WebSocket握手響應消息中返回它們而終止連接。 所需要的擴展列表應該出現在關閉幀的/reason/部分。

  注意，這個狀態碼不能被服務器端使用，因為它可以失敗WebSocket握手。

• 1011

  1011表示服務器端因為遇到了一個不期望的情況使它無法滿足請求而終止連接。

• 1015

  1015是一個保留值，且不能由端點在關閉幀中被設置為狀態碼。它被指定用在期待一個用於表示連接由於執行TLS握手失敗而關閉的狀態碼的應用中（比如，服務器證書不能驗證）。

7.4.2.保留的狀態碼范圍

• 0-999

  0-999范圍內的狀態碼不被使用。

• 1000-2999

  1000-2999范圍內的狀態碼保留給本協議、其未來的修訂和一個永久的和現成的公共規范中指定的擴展的定義。

• 3000-3999

  3000-3999范圍內的狀態碼保留給庫、框架和應用使用。這些狀態碼直接向IANA注冊。本規范未定義這些狀態碼的解釋。

• 4000-4999

  4000-4999范圍內的狀態碼保留用於私有使用且因此不能被注冊。這些狀態碼可以被在WebSocket應用之間的先前的協議使用。本規范未定義這些狀態碼的解釋。