Docling 从 Hugging Face 下载模型权重报 SSL CERTIFICATE_VERIFY_FAILED 怎么解决【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling处理 PDF 文档时Docling 的 AI 流水线需要从 Hugging Face 下载模型权重PDF 管线依赖ds4sd/docling-models见 FAQ默认在首次使用时自动拉取。如果这一步失败终端会抛出类似下面的错误URLError: urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1000)这是 Docling 官方 FAQ 中收录的已知问题SSL error downloading model weights见 docs/faq/index.md发生在从 Hugging Face 获取模型权重的过程中。原因是 Python 环境没有一份最新的可信证书列表导致 TLS 握手时无法验证对端证书。下面按 FAQ 给出的三种方案依次处理并给出验证方式。确认错误是否属于这种情况先核对两点确认你遇到的是同一个问题报错发生在 Docling 运行过程中且提示是在拉取模型时失败——典型触发点是首次转换 PDF模型默认首次使用即自动下载或执行模型预取命令时错误信息包含[SSL: CERTIFICATE_VERIFY_FAILED]与unable to get local issuer certificate。两者都符合再按下面的方案修复如果报错内容不同例如是网络不通、代理拦截FAQ 未覆盖需要另行排查。解决方案一升级 certifi推荐先试最简单的一步是让 Python 环境使用最新的certifi证书包pip install --upgrade certifi执行后直接重新触发一次模型下载见下文验证修复是否生效。FAQ 将这条列为首选方案因为大多数情况下旧证书列表就是根因。解决方案二改用系统证书pip-system-certs如果升级certifi后仍然报同样错误可以改用 pip-system-certs 包让 Python 直接信任你操作系统上的最新证书pip install pip-system-certs安装后重启终端中的 Python 进程再验证因为该包需要在解释器启动时生效。解决方案三显式指定证书文件路径前两条都不奏效时用certifi自己报出的证书路径显式设置环境变量SSL_CERT_FILE和REQUESTS_CA_BUNDLE再运行你的 Docling 任务CERT_PATH$(python -m certifi) export SSL_CERT_FILE${CERT_PATH} export REQUESTS_CA_BUNDLE${CERT_PATH}FAQ 原文给出的就是这段 shell 脚本先执行python -m certifi取得本机 certifi 自带的 CA bundle 路径存入CERT_PATH再把它同时导出给SSL_CERT_FILEssl 模块和REQUESTS_CA_BUNDLErequests 库。环境变量只对当前 shell 会话生效重开终端后需要重新设置。验证修复是否生效修复后有两种方式确认下载链路已恢复任选其一方式一直接用模型预取工具拉取模型。这是 Model prefetching and offline usage 一节描述的docling-tools models download命令下载完成后会打印各模型的落盘位置。下面是文档中的示例输出仅用于说明输出格式实际下载的模型集合随版本与配置略有差异$ docling-tools models download Downloading layout model... Downloading tableformer model... Downloading picture classifier model... Downloading code formula model... Downloading rapidocr torch ch models... Downloading rapidocr onnxruntime ch models... Models downloaded into $HOME/.cache/docling/models.若命令顺利跑完并打印出模型下载完成信息说明证书问题已解决。方式二跑一次真实的 PDF 转换等价于复现最初触发错误的场景docling FILE.pdfFILE.pdf替换为你自己的测试 PDF 路径。命令正常结束并产出转换结果、不再抛出CERTIFICATE_VERIFY_FAILED即为修复成功。如果只需要单个 Hugging Face 仓库的模型也可以用 advanced options 文档 中的docling-tools models download-hf-repo ds4sd/SmolDocling-256M-preview其中仓库 id 是示例值换成你实际需要的repo_id即可。限制与说明以上三种方案都针对能连上 Hugging Face 但 TLS 证书校验失败这一种现象文档没有覆盖代理拦截、内网防火墙等其他失败形态。如果你的目标本来就是完全离线运行air-gapped 环境正确做法不是绕过证书校验而是在联网机器上完成模型下载后通过PdfPipelineOptions(artifacts_pathyour location)、CLI 参数--artifacts-path或环境变量DOCLING_ARTIFACTS_PATH指向本地模型目录——Docling 本身不依赖远程服务见 FAQ 与 Model prefetching and offline usage。若报错只在某个特定 Python 环境出现例如虚拟环境与系统 Python 并存注意先which python/which pip确认升级certifi与python -m certifi用的是同一个解释器再重新验证。【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Docling 从 Hugging Face 下载模型权重报 SSL CERTIFICATE_VERIFY_FAILED 怎么解决？
Docling 从 Hugging Face 下载模型权重报 SSL CERTIFICATE_VERIFY_FAILED 怎么解决【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling处理 PDF 文档时Docling 的 AI 流水线需要从 Hugging Face 下载模型权重PDF 管线依赖ds4sd/docling-models见 FAQ默认在首次使用时自动拉取。如果这一步失败终端会抛出类似下面的错误URLError: urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1000)这是 Docling 官方 FAQ 中收录的已知问题SSL error downloading model weights见 docs/faq/index.md发生在从 Hugging Face 获取模型权重的过程中。原因是 Python 环境没有一份最新的可信证书列表导致 TLS 握手时无法验证对端证书。下面按 FAQ 给出的三种方案依次处理并给出验证方式。确认错误是否属于这种情况先核对两点确认你遇到的是同一个问题报错发生在 Docling 运行过程中且提示是在拉取模型时失败——典型触发点是首次转换 PDF模型默认首次使用即自动下载或执行模型预取命令时错误信息包含[SSL: CERTIFICATE_VERIFY_FAILED]与unable to get local issuer certificate。两者都符合再按下面的方案修复如果报错内容不同例如是网络不通、代理拦截FAQ 未覆盖需要另行排查。解决方案一升级 certifi推荐先试最简单的一步是让 Python 环境使用最新的certifi证书包pip install --upgrade certifi执行后直接重新触发一次模型下载见下文验证修复是否生效。FAQ 将这条列为首选方案因为大多数情况下旧证书列表就是根因。解决方案二改用系统证书pip-system-certs如果升级certifi后仍然报同样错误可以改用 pip-system-certs 包让 Python 直接信任你操作系统上的最新证书pip install pip-system-certs安装后重启终端中的 Python 进程再验证因为该包需要在解释器启动时生效。解决方案三显式指定证书文件路径前两条都不奏效时用certifi自己报出的证书路径显式设置环境变量SSL_CERT_FILE和REQUESTS_CA_BUNDLE再运行你的 Docling 任务CERT_PATH$(python -m certifi) export SSL_CERT_FILE${CERT_PATH} export REQUESTS_CA_BUNDLE${CERT_PATH}FAQ 原文给出的就是这段 shell 脚本先执行python -m certifi取得本机 certifi 自带的 CA bundle 路径存入CERT_PATH再把它同时导出给SSL_CERT_FILEssl 模块和REQUESTS_CA_BUNDLErequests 库。环境变量只对当前 shell 会话生效重开终端后需要重新设置。验证修复是否生效修复后有两种方式确认下载链路已恢复任选其一方式一直接用模型预取工具拉取模型。这是 Model prefetching and offline usage 一节描述的docling-tools models download命令下载完成后会打印各模型的落盘位置。下面是文档中的示例输出仅用于说明输出格式实际下载的模型集合随版本与配置略有差异$ docling-tools models download Downloading layout model... Downloading tableformer model... Downloading picture classifier model... Downloading code formula model... Downloading rapidocr torch ch models... Downloading rapidocr onnxruntime ch models... Models downloaded into $HOME/.cache/docling/models.若命令顺利跑完并打印出模型下载完成信息说明证书问题已解决。方式二跑一次真实的 PDF 转换等价于复现最初触发错误的场景docling FILE.pdfFILE.pdf替换为你自己的测试 PDF 路径。命令正常结束并产出转换结果、不再抛出CERTIFICATE_VERIFY_FAILED即为修复成功。如果只需要单个 Hugging Face 仓库的模型也可以用 advanced options 文档 中的docling-tools models download-hf-repo ds4sd/SmolDocling-256M-preview其中仓库 id 是示例值换成你实际需要的repo_id即可。限制与说明以上三种方案都针对能连上 Hugging Face 但 TLS 证书校验失败这一种现象文档没有覆盖代理拦截、内网防火墙等其他失败形态。如果你的目标本来就是完全离线运行air-gapped 环境正确做法不是绕过证书校验而是在联网机器上完成模型下载后通过PdfPipelineOptions(artifacts_pathyour location)、CLI 参数--artifacts-path或环境变量DOCLING_ARTIFACTS_PATH指向本地模型目录——Docling 本身不依赖远程服务见 FAQ 与 Model prefetching and offline usage。若报错只在某个特定 Python 环境出现例如虚拟环境与系统 Python 并存注意先which python/which pip确认升级certifi与python -m certifi用的是同一个解释器再重新验证。【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考