返回文章
故障排除2026-06-18•5 分鐘閱讀•CSR.plus 團隊

不完整的憑證鏈:修復缺少的中間體

不完整的憑證鏈:修復缺少的中間體

不完整的憑證鏈:如何診斷和修復遺失的中間件(Nginx / Apache)

直接回答:大多數「憑證鏈錯誤」都不是無效證書——伺服器只是發送葉子而不發送中間件。一個指令可以解決這個問題:計算 openssl s_client -showcerts 傳回的憑證;單一憑證意味著鏈條斷裂。修復方法是一個串聯文件,先是葉子,然後是中間文件:將 Nginx ssl_certificate 指向它,或在 Apache 2.4.8+ 上將鏈放入 SSLCertificateFile 目標中。不要發送根——客戶端已經有了它。

核心概念

三個組成部分

組件角色伺服器應該發送嗎?
葉(終端實體)綁定您的主機名稱是
中級將葉子連結到根是的-缺失意味著鏈條斷裂
根客戶端的信任錨否,已在信任儲存中

鏈條如何運作

客戶直接信任根源。您的葉子由不在其信任存儲中的中間體簽名,因此伺服器必須在握手期間發送它,以便客戶端構建葉子→中間體→根。為什麼必須傳送中間體:客戶端只信任本機根;沒有中間體就無法建置路徑。

為什麼有些客戶有效而有些卻失敗

有些用戶端快取中間體或透過 AIA 擴充功能取得遺失的連結;其他的——舊版 Android、Java/OpenJDK、curl、Node、監控代理程式——會立即失敗。伺服器永遠不應該依賴客戶端修復:AIA 獲取不可靠,因為它取決於客戶端實作和網路可達性。

順序很重要

按簽名順序,先是葉子,然後是中間體。錯誤的訂單讓一些客戶徹底崩潰。

讓我們加密目前的層次結構

實務上 ECDSA 葉憑證通常搭配 ECDSA 中繼憑證,但跨演算法簽章在 X.509 中是合法的——真正必須相符的是簽發者與簽章,而非金鑰演算法。

只需 6 個步驟即可修復

步驟 1 — 查看伺服器實際發送的內容

ZXQ代碼0QXZ

計數 BEGIN CERTIFICATE 區塊:1 表示僅葉; 2個或更多是健康的。

步驟 2 — 讀取驗證碼

ZXQ代碼1QXZ

代碼 20 = 未找到發行人(缺少中間體); 21 = 無法驗證第一個憑證; 19 = 自簽章。

第 3 步 — 取得正確的中間體

從 CA 的鏈束或葉的權威資訊存取擴展中獲取正確的中間體。切勿混合世代 - ECDSA 葉子需要 ECDSA 中間體。 證書解碼器 即時顯示頒發者和 AIA。

步驟 4 — 連接(葉在前,無根)

cat leaf.crt intermediate.crt > fullchain.crt

不要附加根:客戶端已將其儲存在本機信任儲存中。

第 5 步 — 設定伺服器

Nginx:只有ssl_certificate和ssl_certificate_key;不存在單獨的鏈指令,因此中間體必須位於同一個檔案中,葉在前。

ssl_certificate     /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;

Apache 2.4.8+:SSLCertificateChainFile 已刪除;將鏈放入 SSLCertificateFile 引用的檔案中。

Certbot 使用者:cert.pem 僅是葉子(使用它是此錯誤的根本原因),chain.pem 僅是中間體,fullchain.pem 是您配置的內容。CDN:CDN用自己的憑證終止TLS;僅上傳葉子會將相同的斷鍊轉發給訪客。

第 6 步 — 驗證

openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem   # expect "leaf.pem: OK"

然後使用 SSL 檢查器 並從乾淨的瀏覽器設定檔進行外部重新測試。

故障排除清單

症狀/代碼意義修復
驗證錯誤:num=20 無法取得本地頒發者憑證缺少中間體,或根本不存在檢查伺服器發送了多少個憑證
驗證錯誤:num=21 無法驗證第一個憑證伺服器不傳送中間體建立全鏈並重新載入
驗證錯誤:num=19 自簽名憑證自簽名憑證正在使用切換到公共信任的憑證
Chrome NET::ERR_CERT_AUTHORITY_INVALID路徑建置失敗相同的修復,然後在清除快取的情況下重新測試
Java PKIX 路徑建置失敗TrustStore 缺少 CA 或未傳回中間體傳送完整鏈;不要相信「它在瀏覽器中開啟」
curl / Node 失敗,瀏覽器正常工作瀏覽器掩蓋了問題將curl 視為真實情況
僅部分 Android 設備故障舊信任存儲,無 AIA 獲取發送完整鏈
中繼憑證並未簽發該葉憑證鏈檔案放錯中繼憑證換成 subject 與葉憑證 issuer 一致的中繼憑證
您配置了 cert.pem僅葉,無中間體切換到 fullchain.pem
CDN/負載平衡器與源端不一致兩側不同鏈兩側更新全鏈

進一步閱讀

工具: SSL 檢查器 檢查即時鏈 · 憑證解碼器 顯示頒發者和 AIA · 憑證和金鑰匹配器 也確認憑證和金鑰對

相關:SSL 憑證格式說明 · 檢查憑證是否與其私密金鑰相符 · [ACME HTTP-01 與 DNS-01](/articles/acme-http-01-vs-dns

更深入:SSL 憑證:完整指南 · 憑證類型比較 · SSL 憑證選擇器

常見問題

我應該將根包含在全鏈中嗎?

不,客戶已經有了;發送它只會增加位元組和混亂。

為什麼 Chrome 可以工作,而curl、Java 或 Android 卻失敗?

有些客戶端快取中間體或透過 AIA 取得它們;其他人則不然。透過curl 來判斷,而不是透過瀏覽器來判斷。

CDN 會隱藏這一點嗎?

不會。 CDN 使用自己的憑證終止 TLS,因此僅上傳葉子會將損壞的鏈傳遞給訪客。

cert.pem、chain.pem 和 fullchain.pem 有什麼不同?

在Certbot的目錄中:cert.pem僅是葉子,chain.pem僅是中間體,fullchain.pem是葉子+中間體。在 Nginx/Apache 中使用 fullchain.pem。

我需要對 Let's Encrypt 的新根做什麼?

通常不需要手動操作-客戶端會自動接收新鏈。只需確保沒有配置固定特定的中間體,並且舊客戶端的信任儲存包含 ISRG 根 X1/X2。

免費 SSL/TLS 工具

數秒內驗證並檢查你的憑證。

相關憑證資訊

進一步了解如何選擇和購買 SSL 憑證。