UnmanagedCallersOnly 方法不能被本地代码直接回调
这是最常被误解的一点:
UnmanagedCallersOnly属性只控制「托管方法能否被非托管代码调用」,但它**不提供回调机制**。它只是让一个
static方法具备 C ABI 兼容签名(如
__cdecl),并禁用 JIT 编译器的某些优化(比如栈探针、GC 检查),从而能被
GetProcAddress或函数指针安全调用。但它本身不注册、不导出、不维护任何跨语言回调通道。
本地代码回调托管方法必须靠委托 + Marshal.GetFunctionPointerForDelegate
真正可行的路径是:在托管侧定义一个匹配本地函数签名的委托类型,实例化委托,再用
Marshal.GetFunctionPointerForDelegate转成原生函数指针,把该指针传给本地库(比如通过初始化 API 或回调注册函数)。关键点: 委托类型必须用
UnmanagedFunctionPointer显式指定调用约定(通常是
CallingConvention.Cdecl或
StdCall),否则指针调用时会栈失衡 委托实例必须长期存活(不能被 GC 回收),需保存强引用(如 static 字段或
GCHandle.Alloc) 若回调可能从非主线程进入,方法体内需注意线程上下文(如 UI 线程需调度,但
UnmanagedCallersOnly方法默认无上下文)
GetFunctionPointerForDelegate返回的指针在 .NET 5+ 中是稳定的,但仅限于 delegate 实例生命周期内有效
为什么不用 UnmanagedCallersOnly 做回调入口?
因为
UnmanagedCallersOnly方法没有托管对象实例上下文,无法捕获闭包、无法访问
this、无法调用非静态成员——它本质上就是个裸函数。而绝大多数回调场景需要携带状态(比如传入的
void*用户数据、事件处理器对象等)。常见错误现象: 试图把
UnmanagedCallersOnly方法地址硬编码传给本地库,结果调用时崩溃(
AccessViolationException或静默失败) 用
typeof(MyClass).GetMethod("Callback").MethodHandle.GetFunctionPointer() 取地址 —— 这返回的是内部 JIT 地址,不可用于跨语言调用
委托未持久引用,GC 后指针悬空,本地代码一回调就触发 AV
一个最小可运行示例(C# → C DLL 回调)
假设本地 DLL 提供:
typedef void (*callback_t)(int code, const char* msg);和
void set_callback(callback_t cb);
// 托管侧
[UnmanagedFunctionPointer(CallingConvention.Cdecl)]
delegate void LogCallback(int code, IntPtr msg);
<p>static LogCallback _callback = (code, msg) =>
{
var str = Marshal.PtrToStringUTF8(msg);
Console.WriteLine($"[{code}] {str}");
};</p><p>// 必须保持引用!
static IntPtr _callbackPtr;</p><p>static void Init()
{
_callbackPtr = Marshal.GetFunctionPointerForDelegate(_callback);
set_callback((callback_t)_callbackPtr); // P/Invoke 导入的 set_callback
}漏掉
_callback的 static 引用,或没调用
Init(),回调就会失效。这也是最容易被忽略的环节:不是写对了就能用,而是得管住生命周期。
