使用 Address Sanitizer 调试内存损坏问题

本文档介绍了如何在使用 AGDE 时启用特殊的调试工具。这些工具有助于调试难以诊断的内存损坏问题和覆盖错误。

HWAddress Sanitizer 和 Address Sanitizer

HWAddress Sanitizer (HWASan) 和 Address Sanitizer (ASan) 都是内存损坏调试工具，可帮助您调试如下内存损坏问题和覆盖错误：

• 堆栈缓冲区上溢和下溢
• 堆缓冲区上溢和下溢
• 堆栈对象使用超过定义范围
• 内存释放两次以及释放内存的参数为非法值
• 访问堆栈上已被释放的内存（仅限 HWAsan）

注意：请尽可能使用 HWASan。因为与 ASan 相比，HWASan 的速度更快且开销更低。

我们建议您仅在调试问题或执行自动化测试时启用 HWASan 或 ASan。尽管这些工具性能出色，但使用时可能会造成不利影响。

运行时行为

启用后，HWASan 和 ASan 会在应用的整个运行时期间自动检查是否存在内存损坏问题。

如果检测到内存错误，应用会因 SIGBART（信号中止）错误而崩溃，并向 logcat 输出详细消息。该消息的副本也会写入 /data/tombstones 下的文件中。

错误消息大致如下所示：

ERROR: HWAddressSanitizer: tag-mismatch on address 0x0042a0826510 at pc 0x007b24d90a0c
WRITE of size 1 at 0x0042a0826510 tags: 32/3d (ptr/mem) in thread T0
    #0 0x7b24d90a08  (/data/app/com.example.hellohwasan-eRpO2UhYylZaW0P_E0z7vA==/lib/arm64/libnative-lib.so+0x2a08)
    #1 0x7b8f1e4ccc  (/apex/com.android.art/lib64/libart.so+0x198ccc)
    #2 0x7b8f1db364  (/apex/com.android.art/lib64/libart.so+0x18f364)
    #3 0x7b8f2ad8d4  (/apex/com.android.art/lib64/libart.so+0x2618d4)

0x0042a0826510 is located 0 bytes to the right of 16-byte region [0x0042a0826500,0x0042a0826510)
allocated here:
    #0 0x7b92a322bc  (/apex/com.android.runtime/lib64/bionic/libclang_rt.hwasan-aarch64-android.so+0x212bc)
    #1 0x7b24d909e0  (/data/app/com.example.hellohwasan-eRpO2UhYylZaW0P_E0z7vA==/lib/arm64/libnative-lib.so+0x29e0)
    #2 0x7b8f1e4ccc  (/apex/com.android.art/lib64/libart.so+0x198ccc)

前提条件

安装 Android OS 的 HWASan build

如需使用 HWASan，请按照 HWASan 文档中的设置说明，安装适用于 Google Pixel 设备的 Android OS 的 HWASan build。

对于其他设备，请与制造商联系，获取操作系统的 HWASan build（如有），或使用纯软件的 ASan 工具。

注意：您不能在专为 HWASan 打造的设备上使用 ASan。

在项目中使用共享 C++ 标准库

受已知问题影响，使用 libc++_static 时 ASan 与 C++ 异常处理机制不兼容。使用 libc++_shared 时则不会发生这个问题。

HWASan 有自己的运算符 new 和 delete 实现，如果标准库是以静态方式关联到项目的，则您无法使用此实现。

注意：使用这些功能时，您必须在项目中使用标准库的共享版本。

如需更改此设置，请参阅本文档的关联 C++ 标准库部分。

注意：如果您已启用 ASan 但未启用 C++ 共享库，将会遇到构建错误。

启用帧指针生成功能

HWASan 和 ASan 使用基于帧指针的快速展开程序 (unwinder)，根据内存分配和取消分配事件来生成堆栈轨迹信息。也就是说，您必须在 C++ 编译器设置中启用帧指针生成功能，才能使用这些功能。具体来说，您需要停用帧指针省略优化功能。

如需更改此设置，请参阅本文档的启用帧指针生成功能部分。

注意：如果您已启用 ASan 但未启用帧指针生成功能，将会遇到构建错误。

配置 Visual Studio 项目以使用 HWASan 或 ASan

启用 HWASan 或 ASan

如需启用 HWASan 或 ASan，请在项目的 Property Pages 中，依次选择 Configuration Properties > General。

图 1：Visual Studio Solution Explorer 窗口中项目的 Properties 选项。

图 2：“General”项目属性中的 Address Sanitizer (ASan) 设置。

如需为项目启用 HWASan，请将 Address Sanitizer (ASan) 设置更改为 Hardware ASan Enabled (fsanitize=hwaddress)。

如需为项目启用 ASan，请将 Address Sanitizer (ASan) 设置更改为 ASan Enabled (fsanitize=address)。

注意：为避免产生不必要的开销，当您不再需要使用这些工具时，请记得重新将属性值设置为 Disabled。

启用帧指针生成功能

帧指针生成功能由 Omit Frame Pointer C/C++ 编译器设置控制。在项目的 Property Pages 中，依次选择 Configuration Properties > C/C++ > Optimization，即可找到该设置。

图 3：Omit Frame Pointer 设置的位置。

使用 HWASan 或 ASan 时，请将 Omit Frame Pointer 设置设为 No (-fno-omit-frame-pointer)。

注意：不使用 HWASan 或 ASan 时，请务必将此属性值重置为原始设置。

在共享库模式下关联 C++ 标准库

前往项目的 Property Pages，然后依次选择 Configuration Properties > General，即可在 Project Defaults 部分下找到 C++ 标准库的链接器模式设置。

图 4：C++ 标准库的链接器模式设置的位置。

使用 HWASan 或 ASan 时，请将 Use of STL 设置为 Use C++ Standard Libraries (.so)。此值会以“共享库”的形式，将 C++ 标准库关联到您的项目，而这是 HWASan 和 ASan 正常运行所必需的。

注意：请勿使用 GNU STL 库，因为 NDK 25 或更高版本不支持这些库。如需了解详情，请参阅 NDK 文档中关于 C++ 支持的内容。

注意：使用完 HWASan 或 ASan 后，记得将这些设置恢复为原始值。

创建 build 配置以供 Address Sanitizer 使用

如果您只是想暂时使用 HWASan 或 ASan，可能就不会仅仅因为此目的而创建新的 build 配置。如果项目规模较小、您打算探索该功能或要处理测试过程中发现的问题，就可能会出现这种情况。

不过，如果您认为此功能很有用，并且计划经常使用，则可以考虑为 HWASan 或 ASan 创建新的 build 配置，如 Teapot 示例所示。举例来说，如果您要在单元测试过程中或游戏的夜间冒烟测试期间定期运行 Address Sanitizer，就可以采取这种做法。

如果您的大型项目使用大量不同的第三方库，且您通常会以静态方式将这些库关联到 C++ 标准库，那么创建单独的 build 配置可能会特别有用。专门的 build 配置有助于确保您的项目设置始终准确无误。

如需创建 build 配置，请在项目的 Property Pages 中，点击 Configuration Manager… 按钮，打开 Active solution configuration 下拉列表。然后选择所需项 ，使用适当的名称（例如“HWASan enabled”）创建新 build 配置。