問題背景

在使用 Hugging Face 的 SentenceTransformer 加載預訓練模型 all-MiniLM-L6-v2 時，遇到了以下錯誤：

1. 代理連接失敗（ProxyError / SSLError: KRB5_S_TKT_NYV）
2. 大文件下載中斷（unexpected EOF while reading）
3. trust_remote_code 參數不兼容（TypeError）

經過多次嘗試，最終成功解決。本文將詳細記錄問題原因和解決方案，幫助遇到類似問題的開發者。

---

錯誤日志分析

1. 代理連接失敗（ProxyError / SSLError）

初始報錯：

urllib3.exceptions.ProxyError: ('Unable to connect to proxy', SSLError(1, '[SSL: KRB5_S_TKT_NYV] unexpected eof while reading (_ssl.c:1091)'))

原因：

• 網絡環境需要通過代理訪問 Hugging Face，但 Python 請求未正確配置代理。
• 代理可能使用了 Kerberos 認證（KRB5_S_TKT_NYV），導致 SSL 握手失敗。

2. 大文件下載中斷（EOF Error）

在下載 model.safetensors（90.9MB）時，連接意外終止：

ssl.SSLError: [SSL: KRB5_S_TKT_NYV] unexpected eof while reading (_ssl.c:2570)

原因：

• 代理服務器不穩定，中斷了長時間連接。
• 企業網絡可能限制大文件下載。

3. trust_remote_code 參數錯誤

TypeError: __init__() got an unexpected keyword argument 'trust_remote_code'

原因：

• trust_remote_code 是 transformers 庫的參數，但 SentenceTransformer 不支持。

---

解決方案

1. 正確配置代理

（1）如果網絡需要代理，設置環境變量：

import os
os.environ["HTTP_PROXY"] = "http://your-proxy:port"  # 替換為實際代理
os.environ["HTTPS_PROXY"] = "http://your-proxy:port"

（2）如果需要用戶名和密碼：

os.environ["HTTP_PROXY"] = "http://username:password@proxy-ip:port"

（3） 如何從電腦查找代理的IP地址和端口號呢？

2. 臨時禁用 SSL 驗證（僅調試）

如果代理證書不受信任，可臨時關閉 SSL 驗證：

import ssl
ssl._create_default_https_context = ssl._create_unverified_context

注意：生產環境不建議這樣做，可能存在安全風險。

3. 手動下載模型

如果代理不穩定，最佳方案是手動下載：

1. 訪問模型頁面：
   (1) all-MinLM-L6-v2
   or
   (2) all-MiniLM-L6-v2 · Hugging Face

2. 下載文件

3. 保存到本地目錄，如 ./local_model/

4. 從本地加載模型：

   model = SentenceTransformer("./local_model")
   

4. 調整超時和重試（可選）

如果網絡較差，可以增加超時時間：

from sentence_transformers import SentenceTransformer
import requestssession = requests.Session()
session.timeout = 120  # 2分鐘超時
model = SentenceTransformer("all-MiniLM-L6-v2", request_session=session)

---

最終代碼示例

import os
from sentence_transformers import SentenceTransformer# 1. 設置代理（如果需要）
os.environ["HTTP_PROXY"] = "http://your-proxy:port"
os.environ["HTTPS_PROXY"] = "http://your-proxy:port"# 2. 方式1：直接在線下載（可能仍受網絡影響）
try:model = SentenceTransformer("all-MiniLM-L6-v2")
except Exception as e:print("在線下載失敗，改用本地模型:", e)# 3. 方式2：手動下載后從本地加載model = SentenceTransformer("./local_model")print("模型加載成功！")

---

總結

問題	解決方案
代理連接失敗	設置 HTTP_PROXY / HTTPS_PROXY
SSL 證書錯誤	臨時禁用 SSL 驗證（僅調試）
大文件下載中斷	手動下載模型并本地加載
trust_remote_code 錯誤	該參數不適用于 SentenceTransformer

推薦方案：
? 優先手動下載模型，避免代理問題。
? 如果必須在線下載，確保代理配置正確并增加超時時間。

希望這篇指南能幫助你順利加載 Hugging Face 模型！