使用DoclingLoader加载PDF时出现HfHubHTTPError 401未授权问题求助

云原生阿岚

2026-6-13

解决DoclingLoader加载时Hugging Face模型401未授权问题

可行解决方法：

方法1：配置Hugging Face访问令牌
尽管all-MiniLM-L6-v2是公开模型，但部分网络环境下仍需令牌验证。先在Hugging Face官网生成基础访问令牌（无需特殊权限），再通过代码或系统环境变量配置：
```
import os
os.environ["HUGGINGFACEHUB_API_TOKEN"] = "你的Hugging Face令牌"
from langchain_docling import DoclingLoader
source_path = "shared\\abc.pdf"  # Windows路径建议用双反斜杠，或直接用正斜杠"shared/abc.pdf"
loader = DoclingLoader(file_path=source_path)
```
也可直接在系统环境变量中设置HUGGINGFACEHUB_API_TOKEN，避免硬编码。
方法2：手动下载模型到本地并指定路径
直接下载sentence-transformers/all-MiniLM-L6-v2的全部文件，保存到本地目录（如./local-models/all-MiniLM-L6-v2），初始化时指定本地路径：
```
from langchain_docling import DoclingLoader
source_path = "shared/abc.pdf"
loader = DoclingLoader(
    file_path=source_path,
    model_name_or_path="./local-models/all-MiniLM-L6-v2"
)
```
方法3：排查网络与代理设置
若处于受限网络环境（如公司内网），确认能否正常访问Hugging Face域名，或配置代理：
```
import os
os.environ["HTTP_PROXY"] = "http://你的代理地址:端口"
os.environ["HTTPS_PROXY"] = "http://你的代理地址:端口"
```
方法4：清除Hugging Face缓存后重试
缓存损坏可能引发授权异常，找到默认缓存目录~/.cache/huggingface/hub，删除models--sentence-transformers--all-MiniLM-L6-v2相关文件夹，再重新运行代码。