使用IronPDF时遇Failed to create a .NET runtime错误求解决

问题情况 #

跟着IronPDF教程制作PDF阅读器时，运行代码触发RuntimeError，提示无法确定dotnet root，无法创建coreclr运行时。已尝试卸载重装IronPDF，问题未解决。

错误日志 #

---------------------------------------------------------------------------
RuntimeError                              Traceback (most recent call last)
File ~\anaconda3\lib\site-packages\pythonnet\__init__.py:77, in _create_runtime_from_spec(spec, params)
    76 elif spec == "coreclr":
---> 77     return clr_loader.get_coreclr(**params)
    78 else:

File ~\anaconda3\lib\site-packages\clr_loader\__init__.py:121, in get_coreclr(runtime_config, dotnet_root, properties, runtime_spec)
    120 if dotnet_root is None:
--> 121     dotnet_root = find_dotnet_root()
    123 temp_dir = None

File ~\anaconda3\lib\site-packages\clr_loader\util\find.py:57, in find_dotnet_root()
    56 if not dotnet_cli:
---> 57     raise RuntimeError("Can not determine dotnet root")
    59 return dotnet_cli.resolve().parent

RuntimeError: Can not determine dotnet root

The above exception was the direct cause of the following exception:

RuntimeError                              Traceback (most recent call last)
Cell In[10], line 1
----> 1 from ironpdf import *
    3 # Load existing PDF document
    4 pdf = PdfDocument.FromFile("ActaConstitutiva0.pdf")

File ~\anaconda3\lib\site-packages\ironpdf\__init__.py:8
    6 # load .NET core
    7 from pythonnet import load
----> 8 load("coreclr")
    9 # imports
    10 import clr

File ~\anaconda3\lib\site-packages\pythonnet\__init__.py:133, in load(runtime, **params)
    131         set_runtime_from_env()
    132     else:
--> 133         set_runtime(runtime, **params)
    135 if _RUNTIME is None:
    136     raise RuntimeError("No valid runtime selected")

File ~\anaconda3\lib\site-packages\pythonnet\__init__.py:29, in set_runtime(runtime, **params)
    26     raise RuntimeError(f"The runtime {_RUNTIME} has already been loaded")
    28 if isinstance(runtime, str):
---> 29     runtime = _create_runtime_from_spec(runtime, params)
    31 _RUNTIME = runtime

File ~\anaconda3\lib\site-packages\pythonnet\__init__.py:90, in _create_runtime_from_spec(spec, params)
    82     raise RuntimeError(
    83         f"""Failed to create a default .NET runtime, which would
    84             have been "{spec}" on this system. Either install a
(...)
    87             (see set_runtime_from_env)."""
    88     ) from exc
    89 else:
---> 90     raise RuntimeError(
    91         f"""Failed to create a .NET runtime ({spec}) using the
    92         parameters {params}."""
    93     ) from exc

RuntimeError: Failed to create a .NET runtime (coreclr) using the
                parameters {}.

当前环境 #

• Jupyter Notebook 6.4.12
• Python 3.10.6
• ironpdf-2023.7.9（已通过pip成功安装）

运行代码 #

from ironpdf import *

# Load existing PDF document
pdf = PdfDocument.FromFile("mypdf.pdf")

# Extract text and images from PDF document
all_text = pdf.ExtractAllText()
all_images = pdf.ExtractAllImages()

# Or, extract text and images from specific pages
page_2_text = pdf.ExtractTextFromPage(1)
for index in range(pdf.PageCount):
    page_number = index + 1
    images = pdf.ExtractBitmapsFromPage(index)

解决办法 #

1. 安装.NET Core SDK/Runtime #

IronPDF依赖.NET Core环境，需安装.NET 6或更高版本的SDK（推荐SDK，包含Runtime）。安装完成后重启Jupyter Notebook和终端。

2. 手动指定DOTNET_ROOT环境变量 #

如果安装后仍无法自动识别路径，可在导入IronPDF前手动设置：

import os
# 替换为你的.NET实际安装路径，Windows示例：C:\\Program Files\\dotnet
os.environ["DOTNET_ROOT"] = "你的dotnet安装路径"
from ironpdf import *

3. 检查系统PATH环境变量 #

确保系统PATH中包含dotnet的安装路径：

• Windows：C:\Program Files\dotnet
• Linux：/usr/share/dotnet
• macOS：/usr/local/share/dotnet

4. 验证.NET安装有效性 #

打开终端/命令提示符，运行dotnet --version，若能正常显示版本号则说明安装成功。

内容的提问来源于stack exchange，提问作者user22290650