安装pythonnet后执行import clr抛出异常的原因及解决咨询

环境信息 #

• Python版本：3.10.12
• 虚拟环境已安装包：
  • cffi 1.16.0
  • clr-loader 0.2.6
  • pip 23.0.1
  • pycparser 2.22
  • pythonnet 3.0.3
  • setuptools 65.5.0
• Mono版本信息：

Copyright (C) 2002-2014 Novell, Inc, Xamarin Inc and Contributors. www.mono-project.com
        TLS:           
        SIGSEGV:       normal
        Notification:  kqueue
        Architecture:  arm64
        Disabled:      none
        Misc:          softdebug 
        Interpreter:   yes
        LLVM:          supported, not enabled.
        Suspend:       preemptive
        GC:            sgen

错误信息 #

执行import clr时抛出：

OSError: cannot load library '/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib': dlopen(/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib, 0x000A): tried: '/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib' (no such file), '/System/Volumes/Preboot/Cryptexes/OS/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib' (no such file), '/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib' (no such file).  Additionally, ctypes.util.find_library() did not manage to locate a library called '/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib'

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

RuntimeError: Failed to create a default .NET runtime, which would
                    have been "mono" on this system. Either install a
                    compatible runtime or configure it explicitly via
                    `set_runtime` or the `PYTHONNET_*` environment variables
                    (see set_runtime_from_env).

原因分析 #

1. Mono版本过旧且架构适配不足：当前使用的Mono是2014年的版本，远低于pythonnet 3.0.3要求的最低兼容版本（至少Mono 5.0+），且旧版Mono未针对arm64架构提供完整的libmonosgen-2.0.dylib库文件。
2. 路径匹配失败：pythonnet默认查找的Mono库路径不存在，旧版Mono的安装结构与pythonnet的预期不匹配。
3. 运行时自动检测失效：由于Mono版本过旧，clr-loader无法正确识别并加载对应的运行时库。

解决步骤 #

1. 替换为兼容的Mono版本 #

• 卸载旧版Mono：删除macOS上的旧版Mono框架：

  sudo rm -rf /Library/Frameworks/Mono.framework
  sudo rm /etc/paths.d/mono-commands
  

• 安装适配arm64的最新稳定版Mono：选择官方提供的arm64版本Mono（建议6.x以上稳定版）完成安装。

2. 验证Mono库路径 #

安装完成后，检查目标库文件是否存在：

ls /Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib

若文件存在，说明路径匹配正常；若不存在，需重新安装Mono确保文件完整。

3. 手动配置pythonnet运行时（可选） #

如果自动检测仍失败，可在代码中手动指定Mono运行时：

import clr_loader
from pythonnet import set_runtime

# 加载Mono运行时
set_runtime(clr_loader.get_mono_runtime())
import clr

或通过环境变量预先配置：

export PYTHONNET_RUNTIME=mono
export PYTHONNET_MONO_LIB=/Library/Frameworks/Mono.framework/Versions/Current/lib/libmonosgen-2.0.dylib

访问.NET Standard 2.0 DLL的步骤 #

1. 确认DLL完整性：确保目标DLL是针对.NET Standard 2.0编译的，且所有依赖项已放置在可访问路径下。
2. 添加DLL引用：

   # 导入clr后添加DLL路径
   clr.AddReference("/full/path/to/your/dll/file.dll")
   

3. 调用DLL中的函数/类：

   # 导入DLL中的命名空间和类
   from YourDllNamespace import TargetClass
   
   # 创建实例并调用方法
   obj = TargetClass()
   result = obj.TargetMethod(parameter1, parameter2)
   

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