angr 工具特有坑与边界

版本与安装坑

Python 版本线：当前主线为 10.x；9.3.0 起要求 Python 3.12+（PyPI requires-python 实测）；9.2.x 下限随补丁版本抬高（9.2.91 要求 ≥3.8、9.2.203 已要求 ≥3.10），不能按「9.2.x」整线判断——装前以目标版本的 PyPI requires-python 为准（pip index versions angr 看可用版本）；9.3 装到 3.11 会直接拒绝或编译失败，老的 9.2 装到 3.13 也可能无 wheel
主版本间 API 变更：angr 9.1（迁移文档有专页）改过 SimState/state.posix 等细节；网上旧教程（8.x 时代）的 state.mem、simprocedures 写法可能失效——以目标版本 docs 的 "Migrating to angr X" 为准
binutils 依赖：angr 处理/重写二进制（angr.Project 的 back-end 或 angr.SimProcedure 无关但 binary rewriting 相关操作）会调 objcopy——Linux 装 binutils，缺了报 objcopy: command not found 类错误
Windows 支持边界：Windows 下 pip 装 win32 wheel 可用，但部分 cle/ELF 后端与 fork 类操作受限；需要 ELF/arm 目标分析时优先 WSL 内装 Linux 版
多环境共存：angr 依赖树大（pyvex/unicorn/claripy 等），别往系统解释器塞——venv 隔离，升级先看依赖是否连带升

PIE 基址：angr 默认按 0x400000 装载，Ghidra 按 0x100000 显示——find/avoid 地址必须换算（p.loader.main_object.mapped_base 核对实际基址）
auto_load_libs 默认值：新版本默认 auto_load_libs=False 而旧版本为 True——行为差异导致同一脚本结果不同；显式写参数，别依赖默认
壳/静态链接目标：带壳目标先脱壳（re-unpack-simple）；静态链接大二进制装载后状态数爆炸——hook 掉无关库函数入口
架构/字节序：arm/armeb/mips 目标 angr 支持但要注意字节序（archinfo 按 ELF header 自动选）；file target 先确认再建 Project

除零约束缺失：Z3 对 a/b 分母为 0 求值为全 1（4294967295）——涉除法表达式显式加"分母非零"约束
未初始化寄存器/内存被自动符号化：entry_state 对未初始化值生成无约束符号，求解空间虚胖、结果含垃圾——ZERO_FILL_UNCONSTRAINED_MEMORY/ZERO_FILL_UNCONSTRAINED_REGISTERS 或显式设已知初值
float/NaN：浮点路径 Z3 与实机可能不一致（FP 舍入/NaN 语义）——浮点校验题优先人工还原或换 re-z3 单独建模
eval 返回值的陷阱：eval(expr, cast_to=bytes) 对非整字节宽符号（如 6 字节长度符号）按位宽对齐返回，多解时 n= 取多个逐一重放验证
求解超时：复杂约束集 eval 可能分钟级无回——timeout= 设上限，配合 solver.min/max 缩小搜索
约束集合 ≠ 路径语义：angr 求解器拿的是该状态累积路径约束，不是"程序全部行为"——求解出的输入必须沙箱内原样重放验证（re-analyze/platform-tips 最高原则）

摘要不准：strlen/malloc 等 SimProcedure 替代实现有 bug 或不完整，结果反直觉（错误返回值/绕过校验）——异常先怀疑摘要：禁用对应 hook 或 project.hook 自定义
hook 未卸掉：hook 分发器后执行跳回再次进 hook 死循环——跳到目标块后立即 unhook
hook_symbol 与库调用路径：hook_symbol 只影响按符号解析的调用；地址间接调用要 project.hook(addr, ...) 按地址挂
cmovxx 不分裂分支：angr 对 cmov 通过积累约束实现而非分裂两个状态——需要后继关系时手动 state.copy() 分裂并跳过 cmov 指令