BlockHook 兼容性实战Stack Block、Global Block 与 dispatch_block_t 的 Hook 技巧合集【免费下载链接】BlockHookHook Objective-C blocks. A powerful AOP tool.项目地址: https://gitcode.com/gh_mirrors/bl/BlockHookBlockHook 是一款基于 libffi 的 Objective-C Block 挂钩Hook工具能在不改动业务代码的前提下对任意 Block 进行 Before、Instead、After、Dead 四种模式的拦截与增强。很多初学者会以为 Block 只有一种形态但在实际项目中Stack Block栈 Block、Global Block全局 Block和dispatch_block_t三类 Block 的内存布局与生命周期完全不同Hook 起来的注意点也大相径庭。这篇文章将围绕 BlockHook 兼容性实战为你梳理这三类 Block 的 Hook 技巧合集让你少踩坑、快上手。认识三种 BlockStack Block、Global Block 与 Malloc Block 的区别在开始 Hook 之前先花 1 分钟认清 Block 的三种形态Block 类型特征生命周期Stack Block栈 Block在函数体内创建、未 copy随栈帧销毁极易野指针Global Block全局 Block不捕获任何外部变量、编译期静态分配与进程同生命周期Malloc Block堆 Block通过 copy 进入堆区引用计数管理BlockHook 对三类 Block 的兼容策略写在了核心源码 BlockHook.m 中判断 Block 类型的关键逻辑则在 BHHelper.m 的BHBlock结构与 flags 位域里BLOCK_IS_GLOBAL、BLOCK_HAS_SIGNATURE等标志位。理解这些差异是掌握 Hook 技巧合集的第一步。Stack Block 如何安全 Hook先 copy 再 Hook 的完整流程Stack Block 是新手最容易翻车的场景。它活在栈上一旦所在函数返回Block 内存即失效。BlockHook 源码BHToken.m对此有明确的防御逻辑当检测到__NSStackBlock时会打印警告 Hooking StackBlock causes a memory leak! I suggest you copy it first!并且该 Token无法被 remove。最安全的 Stack Block Hook 流程如下对 Block 先执行copy让 Block 转为堆上可管理的 Malloc Block再对新副本调用block_hookWithMode:usingBlock:挂接需要移除时直接对BHToken调用remove即可干净还原。为什么 Stack Block 必须先 copy因为 Hook 会替换 Block 的 invoke 函数指针并建立关联对象associated object。栈内存的生命周期太短关联对象存活期间 Block 可能已经消失轻则 Hook 失效重则野指针崩溃。测试用例 BlockHookSampleTests.m 中的testStackBlock和testGlobalBlock是官方给出的对照实验值得反复阅读。Global Block Hook 实战无捕获变量的静态 Block 也能 HookGlobal Block 由于不捕获外部变量编译器将其静态分配生命周期贯穿整个进程。它是最省心的 Hook 对象不涉及野指针、不涉及内存泄漏Before、Instead、After、Dead四种模式可以随意组合remove也毫无压力。一个典型的 Global Block Hook 示例传入给方法的无捕获 Block如^{ NSLog(global block); }在方法内部直接 Hook 即可无需 copy。官方测试testGlobalBlock正是验证了这一场景——Hook 成功后移除 TokenBlock 恢复原状整个过程零风险。dispatch_block_t 也能 Hook绕过私有数据结构的兼容处理技巧dispatch_block_t是最隐蔽的坑。它由dispatch_block_create生成内部包裹了一层 GCD 的私有数据结构dispatch_block_private_data_s直接对其 invoke 函数做替换通常无效甚至可能触发 GCD 内部断言。BlockHook 的巧妙之处在于它在 BlockHook.m 的入口处先调用bh_dispatch_block_get_private_data实现见 BHHelper.m通过魔法数0xD159B10C即 DISPatch_BLOCk识别私有数据然后自动下沉到内部的真实 Block再执行 Hook。这意味着你完全不需要关心 GCD 内部结构直接这样写即可dispatch_block_t block dispatch_block_create(0, ^{ NSLog(Im dispatch_block_t); }); [block block_hookWithMode:BlockHookModeAfter usingBlock:^(BHInvocation *invocation){ NSLog(dispatch_block_t: Hook After); }]; dispatch_async(queue, block);官方测试testDispatchBlockCreate完整演示了这一兼容流程包括异步派发与dispatch_block_cancel的组合使用。四种 Hook 模式组合使用Before / Instead / After / Dead 实战BlockHook 的核心 API 定义在 BlockHook.h模式枚举则来自 BHToken.h支持位或|组合BeforeBlock 执行前插入逻辑可修改参数Instead完全接管执行可调用invokeOriginalBlock保留原实现AfterBlock 执行后追加逻辑可读取/改写返回值DeadBlock 释放时回调用于资源清理与生命周期追踪。实战中常用组合是BlockHookModeBefore | BlockHookModeInstead | BlockHookModeAfter | BlockHookModeDead一次挂满然后在回调里用invocation.mode判断当前阶段。注意 Dead 模式下BHInvocation是唯一参数不要尝试读取业务参数源码里对越界参数做了置 0 保护见测试testOverstepArgs。返回值与参数修改技巧借助 BHInvocation.h 提供的方法你可以像操作NSInvocation一样读写 Block 的参数和返回值getArgument:atIndex:/setArgument:atIndex:修改参数下标从 1 开始getReturnValue:/setReturnValue:读取/改写返回值invokeOriginalBlock调用原始实现retainArguments保留参数异步场景防野指针。testObjectArg、testCGRectArgAndRet、testStructReturn等测试覆盖了对象、结构体、结构体指针等多种类型是排查类型兼容问题的首选参考资料。Hook 的移除与多 Token 管理技巧同一个 Block 可以多次 Hook每次返回一个BHToken且 Token 之间通过next形成链表。管理技巧合集如下单个移除[token remove]会精确还原被替换的 invoke 指针全部移除[block block_removeAllHook]一键清空查看当前block_currentHookToken获取最近一次 Hook 的 Token调试利器token.mangleName直接给出 Block 的符号名如__37-[...]_block_invoke定位代码位置非常方便附加信息每个 Token 自带userInfo字典可在 Hook 之间传递上下文。常见坑位排查清单最后送上一份实战总结的避坑清单Stack Block 必须 copy否则内存泄漏且无法 removedispatch_block_t 直接 Hook 即可BlockHook 已自动下沉内部 Block无需自己解析私有结构Dead 模式不要取业务参数此时 Block 即将销毁异步回调记得retainArguments防止参数提前释放参考 MRCTests.m 的 MRC 场景移除顺序影响结果多个 Token 叠加时按链表依次还原源码中originInvoke的传递逻辑值得研读。如果你希望手动集成而不是通过 CocoaPods/Carthage可以git clone https://gitcode.com/gh_mirrors/bl/BlockHook后仅将BlockHook.h/m加入工程需先引入 libffi。掌握了这份 Hook 技巧合集Stack Block、Global Block 与 dispatch_block_t 都将成为你 AOP 架构中的顺手工具。【免费下载链接】BlockHookHook Objective-C blocks. A powerful AOP tool.项目地址: https://gitcode.com/gh_mirrors/bl/BlockHook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考