debian下使用Sphinx異常「Could not import extension sphinx.builders.linkcheck (exception: cannot import nam

最近使用到Sphinx編譯文檔，出現以下異常：

Extension error:
Could not import extension sphinx.builders.linkcheck (exception: cannot import name SSLError)

一開始有點摸不着頭腦，明明是不能導入「sphinx.builders.linkcheck」，錯誤信息倒是「cannot import name SSLError」

因而使用「-P」參數在異常時打開pdb調試，pdb打印信息以下：

Exception occurred while building, starting debugger:
Traceback (most recent call last):
File "/usr/local/lib/python2.7/dist-packages/Sphinx-1.5b1-py2.7.egg/sphinx/cmdline.py", line 295, in main
opts.warningiserror, opts.tags, opts.verbosity, opts.jobs)
File "/usr/local/lib/python2.7/dist-packages/Sphinx-1.5b1-py2.7.egg/sphinx/application.py", line 189, in __init__
self.setup_extension(extension)
File "/usr/local/lib/python2.7/dist-packages/Sphinx-1.5b1-py2.7.egg/sphinx/application.py", line 514, in setup_extension
err)
ExtensionError: Could not import extension sphinx.builders.linkcheck (exception: cannot import name SSLError)

能夠看到出錯的地方在「application.py」，因而打開該文件一探究竟，源碼以下：

進一步在pdb打印「extension」和「err」

如今能夠知道，是在import的時候遇到了importerror，可是不知道具體是哪裏錯了，乾脆另起python命令行，直接import這個擴展「sphinx.builders.linkcheck」，結果出現以下錯誤：

能夠看到錯誤緣由是不能從「requests.packages.urllib3.exceptions」導入「SSLError」，經驗證發現，能夠在「requests.exceptions」裏面導入「SSLError」

而網上搜索，大多也只是提到從「requests.exceptions」導入「SSLError」。因爲Sphinx是剛下載的最新版，我懷疑多是版本不兼容的問題。

查看requests版本發現requests確實不是最新版本（官網目前最新版本爲：v2.12.1）：

進一步上官網確認，發現官網上有關SSLError的代碼確實已經發生變化：

到此，徹底確認是requests版本更新過程當中改變了「SSLError」的位置（導入方式），升級requests到最新版後問題解決。