使用Python.Net加载IronPdf.dll报错及自定义DLL类导入失败问题咨询

一、IronPdf DLL FileNotFoundException 报错解决 #

• 架构必须匹配：64位Python环境必须使用64位版本的IronPdf DLL，32位Python环境必须使用32位版本的IronPdf DLL，架构不匹配会直接触发找不到程序集的错误
• 依赖完整性检查：IronPdf.dll并非独立程序集，需要把它所有依赖的关联DLL全部放到同一个目录下，缺失依赖也会抛出找不到程序集的异常
• 加载逻辑修正：不要直接传递全路径给clr.AddReference，正确的加载逻辑如下：

import clr
import sys

# 若使用的是.NET Core/.NET 6+ 版本的IronPdf DLL，需先指定加载coreclr运行时
# import pythonnet
# pythonnet.load("coreclr")

# 统一将DLL所在目录加入搜索路径
dll_dir = r"C:\Users\<my-user>\Documents"
if dll_dir not in sys.path:
    sys.path.append(dll_dir)

# 先验证DLL是否可被搜索到
print(clr.FindAssembly("IronPdf"))
# 仅传入程序集名称加载
clr.AddReference("IronPdf")

# 测试导入命名空间
from IronPdf import ChromePdfRenderer

二、自定义DLL加载后无法导入命名空间解决 #

• 首先确认自定义DLL编译时设置的.NET版本与pythonnet加载的运行时版本匹配，若为.NET Core编译的DLL必须先加载coreclr运行时
• 不要直接使用from 命名空间 import 类的写法，先导入命名空间模块再导入类，示例如下：

import clr
import sys

dll_dir = r"你的MathLibrary.dll所在目录"
sys.path.append(dll_dir)

# 加载程序集
clr.AddReference("MathLibrary")
# 先导入命名空间模块
import MathLibrary
# 再导入对应类
from MathLibrary import Class1

# 测试实例化
test_obj = Class1()

• 若仍报错可先执行print(clr.FindAssembly("MathLibrary"))确认DLL路径是否正确，同时检查自定义类的访问修饰符必须为public

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