macOS应用Release构建出现libclang_rt.asan_osx_dynamic.dylib的疑问与解决

安全阿岳

2026-8-13

关于Xcodebuild Release构建中出现libclang_rt.asan_osx_dynamic.dylib的问题解答

1. Release构建中包含该动态库是否不合理？

完全不合理。Address Sanitizer（ASAN）是专门用于调试阶段的内存错误检测工具，它会在运行时插入大量内存检查逻辑，不仅会显著增加应用包体积，还会拖慢应用运行性能。正常的Release构建目标是精简、高效，应该关闭所有调试相关的检测工具，所以这个ASAN动态库出现在Release包中是不符合预期的。

2. 如何阻止Xcode将其包含进去？

针对自定义xcodebuild脚本的场景，可以从以下几个维度排查修复：

检查xcodebuild命令行参数：确认你的构建命令里没有手动添加ASAN相关的编译/链接标志，比如OTHER_CFLAGS="-fsanitize=address"或OTHER_LDFLAGS="-fsanitize=address"，如果有直接删除这些参数。
核对项目/Target的Release构建设置：
- 打开Xcode项目，切换到Release配置，在Build Settings的「Sanitizers」分类下，将Address Sanitizer设置为No
- 检查Other C Flags和Other Linker Flags，确保没有-fsanitize=address这类ASAN相关的配置项
- 如果使用了.xcconfig构建设置文件，打开文件确认是否存在ASAN_ENABLED = YES，改成ASAN_ENABLED = NO
清理构建缓存：旧的构建缓存可能残留ASAN相关产物，先执行xcodebuild clean清理缓存，再重新执行Release构建。
排查自定义构建脚本：如果你的脚本中有修改Xcode构建设置的步骤（比如通过命令行修改项目配置），检查是否有误开启ASAN的逻辑，及时修正。