我是濤思數(shù)據(jù)的運營同學。第一次看到這個問題，是在我負責的一個監(jiān)控后臺，發(fā)現(xiàn)有用戶通過這個問題來到了我們官網(wǎng)。起初我以為只是個例，并且在官網(wǎng)的FAQ中，有關(guān)于此問題的詳細解答，我私認為自己的SEO做得還不錯，遇到這個問題的用戶，隨便搜一搜就能定位到解決辦法，從運營角度來說，It’s not a big deal。

直到我們開始籌劃“每周精選Issue”這個欄目，在我日常Push技術(shù)支持同學給我一個具有代表性的問題時，他跟我說：那就從“failed to connect server”開始吧。

然后我好奇地打開了TDengine Database的GitHub主頁，搜了一下這個問題，竟然有50個之多，并且“failed”方式不盡相同。雖然技術(shù)上的問題我有心無力，但我很能理解大家想解決這個問題的迫切心情，這就好像我打算吃火鍋，準備好了底料、食材和蘸料，也準備好了鍋，然后發(fā)現(xiàn)鍋沒有電……我設身處地地想了一下，確實，很崩潰。

那么，好的，既然你誠心誠意地發(fā)問了，那我就認認真真地告訴你，「每周精選Issue」的第一期就從“failed to connect server”開始吧！

為什么會出現(xiàn)錯誤“failed to connect server”？

仔細看了一下GitHub上關(guān)于此問題的討論，暫時把真的是一個“bug”的情況拋開不談，大多數(shù)情況下報此錯誤，皆是因為你忽視了一些重要的事情。

比如，來自編號#1034，「自問自答」的Issue：java.sql.SQLException: TDengine Error: failed to connect to server。

首先表揚一下這位可愛的用戶，問題敘述的很完整，描述了操作環(huán)境、操作過程、并且上傳了日志，為很多用戶展示了“如何遞交一個Issue”的良好示范……然后，一天之內(nèi)，他自己關(guān)閉了該問題。

他說：找到原因了，我linux服務器上的版本是手工編譯安裝的是1.6.5，客戶端win10用的是1.6.4，因此造成連接不上。

看看，如果提前注意到服務器和客戶端的版本不一致，是不是就能讓自己的體驗過程更順暢呢。（當然，研發(fā)同學說，他們正在努力，不久之后，服務器和客戶端版本不一致，也可以兼容工作，那我們就拭目以待吧?。?/p>

再比如，來自編號#1090，「體驗過時版本」的Issue：Query interrupted (failed to connect to server) 

這位用戶的表中，有一個float字段，在終端查詢時報錯，但將該字段類型改成double就可以拿到結(jié)果，因此他懷疑，TDengine Database是不是不支持針對float的某些查詢。

一番問答下，該問題終于得到解決，原來，這個問題確實是之前某個版本中的一個bug，但早已在新版本中得到了修復，而這位積極提bug的小伙伴卻還在體驗已經(jīng)過時的舊版本，踩了前人已經(jīng)踩過的坑。

新版本是個好東西，你值得擁有。

……

類似的問題還有很多，因此除了真正的bug外，很多時候你多一分認真和仔細，就能解決問題，就比如剛才那個沒有電的鍋，可能僅僅是因為，你沒有接通電源。

遇到“failed to connect server”，有沒有什么辦法去排查問題呢？

當然，可以。我問了我們的技術(shù)支持同學，他有一套解決這類問題的萬能方法，只需兩步，在此不吝分享。

第一步：檢查客戶端和服務器版本是否一致。（正如之前所說，不久之后，這個步驟就完全不需要了。）

第二步：客戶端遇到連接故障，按如下步驟進行檢查：

1. 在服務器上，執(zhí)行 systemctl status taosd 檢查taosd運行狀態(tài)。如果沒有運行，啟動taosd
2. 確認客戶端連接時指定了正確的服務器IP地址，ping服務器IP，如果沒有反應，請檢查你的網(wǎng)絡
3. 檢查防火墻設置，確認TCP/UDP 端口6030-6039 是打開的
4. 對于Linux上的JDBC（ODBC, Python, Go等接口類似）連接，確保libtaos.so在目錄/usr/local/lib/taos中，并且/usr/local/lib/taos在系統(tǒng)庫函數(shù)搜索路徑LD_LIBRARY_PATH中
5. 對于windows上的JDBC, ODBC, Python, Go等連接，確保driver/c/taos.dll在你的系統(tǒng)搜索目錄里 (建議taos.dll放在目錄 C:\Windows\System32)
6. 如果仍不能排除連接故障，請使用命令行工具nc來分別判斷指定端口的TCP和UDP連接是否通暢
   • 檢查UDP端口連接是否工作：nc -vuz {hostIP} {port}
   • 檢查服務器側(cè)TCP端口連接是否工作：nc -l {port}
   • 檢查客戶端側(cè)TCP端口鏈接是否工作：nc {hostIP} {port}

如果按照這兩步檢查并執(zhí)行下來，依然沒有解決你的問題，那你可能真的遇到了bug，不用擔心，我們還有終極萬能法寶，到GitHub上，將此問題進行反饋，當然，需要你附上操作環(huán)境、操作過程和日志，越詳細越好，向我們的研發(fā)工程師尋求幫助。

好了，本期「每周精選Issue」就到這里了，能真正幫助到你，就是這個欄目存在的最大意義。

• 欄目編輯：夏昕
• 技術(shù)支持：蘇曉慰