這篇文章內容會很短，主要是想給大家分享下我最近在做一個簡單的rabbitmq客戶端類庫的封裝的經驗總結，說是簡單其實一點都不簡單。為了節省時間我主要按照Library的執行順序來介紹，在你看來這裡僅僅是一個簡單的經驗總結，但是在我看來這些經驗只有在你真正的封裝rabbitmq客戶端庫的時候且將你的客戶端安全穩定的釋出上線後才會真的發現這些問題。

比如你的庫只是連結單個Node的時候和連結高可用叢集的HAProxy時候是完全兩回事。當你未能在你的庫裡使用反向注入LOG介面的時候一旦在線上發生網路解析和序列化等一系列線上問題時候你是多麼無能為力。當你使用同步迴圈獲取佇列訊息的時候一旦發生異常你的連結就會斷掉等等這些細節。我總結了我在編寫這個library的時候慢慢穩定下來的過程和經驗。至少目前來看網路上的文章，當然我是指.NET/C#方面的，都沒有講到這些問題，大部分的文章都是簡單的介紹了一個最最基本的使用和最最基本的demo而已，達不到企業級使用的要求。在這個過程中，感謝我的團隊和給過我指導的同事，讓我明白了一些技術道理。

好東西不能石沉大海，尤其是.NET領域更需要這樣的東西來填補這一空缺。廢話不多說了，進入主題，那些編寫框架和元件的大道理這裡就不講了，我只說重點。

1.傳送連結、通道和接受連結、通道要關注點分離

就是說你的接受Channel和傳送的Channel要分離開，如果不分開會出現偶發性的訊息串掉的錯誤，我這裡現在沒有環境無法重現截圖。我是在做壓力測試的時候，用了一個Channel的時候Debug丟擲來的異常。如果你有潔癖建議把IConnection也分離開。這樣不容易出錯，就算出錯排錯也會很容易。

（圖1：分開接受和傳送的IConnection、Channel）

還有一點，不要將這些物件直接散落在直接使用的Client類中，要建立起一個使用上下文，就算你暴露在外面的是一個具體的類但是那個類也是一個空殼子。

2.客戶端傳送訊息的時候要標記上訊息的持久化狀態

我們可以在建立佇列的時候設定此佇列是持久化的，但是佇列中的訊息要在我們傳送某個訊息的時候打上需要持久化的狀態標記。

（圖2：標記此訊息是需要持久化的）

3.要在監聽的執行緒入口後加try{}catch{}

（圖1：線上程內部方法中加try{}catch{}）

這個點很多做封裝的人會容易忽視掉，我這裡補充下為了保持這個文章的完整性。

這個時候你的try{}catch{}其實是不會捕獲到任何ListenInit方法中的異常的，因為他在另外一個執行緒上下文中執行的。具體原理這裡就不解釋了。但是可以很容易的理解就是，你這個方法一旦執行就會立馬返回了。

4. 初始化的監聽連線的時候要訂閱Shutdown事件記錄下LOG

（圖4：監聽Shutdown事件，記錄下LOG便於排查和監管服務的穩定性）

5. 要在內部定義一個LOG反向注入介面

（圖5：元件內部的LOG介面）

此介面就是你內部用來將資訊傳輸出去的渠道，而且這個渠道是活的，有各個應用系統決定怎麼記錄。

簡單處理你還需要一個LOG介面服務定位器物件，要不然你拿不到這個介面例項。

（圖6：LOG location物件）

6. 千萬不要使用while（true）接受訊息

如果我們是使用死迴圈的方式在接受訊息，那麼一旦當你的接受訊息的程式出現異常那麼你的while直接就會跳出，你的連結可能是還連結在伺服器上但是你的channel已經斷開，說白了你的訊息是不會接受到的，而且這樣的開發方法很不穩定也不優雅。我們可以使用面向事件的消費者來接受訊息。

（圖7：使用Eventing型別的消費者接受訊息）

7.設定一次只接受一個訊息，而不是直接LOCK住所有的佇列訊息

預設情況下，一個佇列裡不管多少訊息當你一個TCP連線打上去之後會LOCK住所有的訊息，也就是說一個連線徹底佔用了所有的訊息，此時訊息不會被其他叢集的機器消費。

（圖8：一次只取一個訊息進行消費）

但是如果你對訊息的處理的前後順序有要求就不能這麼做，你需要獨立註冊一個佇列，然後將這樣的一此只消費一個訊息配置話。

8.自動重新連線，不需要手動處理自動連線

（圖9：創建出一個會自動重連的Connection物件）

9.心跳超時時間（叢集、高可用部署時至關重要的設定）

（圖10：設定心跳超時時間）

如果你連線單臺節點的時候不設定這個值是沒問題的，但是如果你連線的是類似HAProxy虛擬節點的時候就會出現TCP被斷開的可能性。如果你不設定這個心跳超時時間，它預設是不進行心跳保持的，就會出現網路中的某個設定斷開空閒的TCP連線資源。就這個問題一直搞的我們的團隊到第二天兩點鐘。大家要記住這個點。

10.消費失敗的訊息要重新放入佇列

（圖11：重新放入佇列，推送給其他消費著）

總結：

最後，我是基於Rabbitmq.Client 版本3.5.3.0的基礎上開發的，這個大家要注意。版本不一樣會有一定的差異性。希望此文對大家在使用rabbitmq的同志有一點幫助，謝謝。

github地址：https://github.com/Plen-wang/rabbitmqclient