因_ITERATOR_DEBUG_LEVEL不匹配导致的Address Sanitizer链接错误

Debug构建：_ITERATOR_DEBUG_LEVEL不匹配问题 #

Clang的ASAN运行时库（clang_rt.asan_cxx-x86_64.lib）是用_ITERATOR_DEBUG_LEVEL=0编译的，但你的TestClient Debug构建默认启用了MSVC的调试迭代器（_ITERATOR_DEBUG_LEVEL=2），直接导致符号冲突。

解决办法：在Debug模式下强制统一迭代器调试级别为0，同时确保所有目标使用ASAN兼容的静态运行时库（MT）。

Release构建：RuntimeLibrary不匹配与/INFERASANLIBS错误 #

• RuntimeLibrary不匹配：ASAN运行时依赖静态运行时库（MT），但CMake默认Debug用MDd、Release用MD，两者不兼容，必须统一为MT。
• /INFERASANLIBS错误：Clang自动添加的/INFERASANLIBS选项在lld-link中被禁止，需要禁用自动链接ASAN库，手动指定链接库文件。

修正后的CMakeLists.txt配置 #

替换原有的CMake配置，确保编译选项、运行时库、ASAN设置完全统一：

cmake_minimum_required(VERSION 3.23)

project(AzNet)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 所有构建类型统一用静态运行时库（MT），匹配ASAN要求
set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:>")

# 为所有目标添加ASAN编译选项，Debug带调试信息，Release开优化
add_compile_options(
    $<$<CONFIG:Debug>:-g -fsanitize=address>
    $<$<CONFIG:Release>:-O2 -fsanitize=address>
)

# 添加编译定义，解决迭代器调试级别和STL注释冲突
add_compile_definitions(
    _ITERATOR_DEBUG_LEVEL=0
    _DISABLE_STRING_ANNOTATION=1
    _DISABLE_VECTOR_ANNOTATION=1
)

# 禁用Clang自动链接ASAN库，手动指定避免/INFERASANLIBS错误
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fsanitize=address -nostartfiles")
# 手动链接ASAN运行时库，路径根据你的Clang版本调整，示例为x64架构
link_libraries(
    clang_rt.asan-x86_64.lib
    clang_rt.asan_cxx-x86_64.lib
)

add_subdirectory(Submodules)
add_subdirectory(AzNet)
add_subdirectory(TestClient)
add_subdirectory(TestServer)

额外注意点 #

• ws2_32.lib是Windows系统自带库，没有调试版本，你的问题和它无关，根源是编译选项不匹配。
• 手动链接ASAN库时，若找不到文件，去Clang安装目录下的lib/clang/<你的版本号>/lib/windows路径找。
• 重新构建前记得清空旧的build目录，避免缓存干扰：

rm -rf build/
cmake -G"NMake Makefiles" -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_EXPORT_COMPILE_COMMANDS=1 -S . -B build/
nmake -C build/

内容的提问来源于stack exchange，提问作者DramaticLandscape