UnmanagedCallersOnly方法不能被本地代码直接回调,它仅使静态方法具备C ABI兼容性且禁用部分JIT优化,但不提供回调机制;真正可行的回调路径是使用委托+Marshal.GetFunctionPointerForDelegate,并需显式指定调用约定、保持委托强引用。

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);static LogCallback _callback = (code, msg) => { var str = Marshal.PtrToStringUTF8(msg); Console.WriteLine($"[{code}] {str}"); };
// 必须保持引用! static IntPtr _callbackPtr;
static void Init() { _callbackPtr = Marshal.GetFunctionPointerForDelegate(_callback); set_callback((callback_t)_callbackPtr); // P/Invoke 导入的 set_callback }
漏掉 _callback 的 static 引用,或没调用 Init(),回调就会失效。这也是最容易被忽略的环节:不是写对了就能用,而是得管住生命周期。










