VC++ 64位CLR项目使用cpprestsdk时遇<mutex>不支持编译错误

你的编译错误很典型，根源是Visual Studio的CLR编译模式（/clr）不支持标准库的<mutex>头文件，而cpprestsdk（casablanca）的内部实现依赖了<mutex>，所以直接在CLR项目里用它就会触发这个报错。

先把你遇到的错误信息贴出来方便其他人参考：

1>------ 生成开始: 项目: Timestamp, 配置: Debug x64 ------
1>MyForm.cpp
1>c:\program files (x86)\microsoft visual studio\2017\community\vc\tools\msvc\14.13.26128\include\mutex(8): 致命错误 C1189: #error: 在使用 /clr 或 /clr:pure 编译时不受支持。
1>Testapi.cpp
1>c:\program files...

下面是几个实用的解决办法，按推荐优先级排序：

1. 把cpprestsdk代码隔离到原生C++模块中 #

这是最稳妥的方案，原理是让CLR项目和cpprestsdk的原生代码分离开：

• 新建一个原生C++ DLL项目（不要启用CLR支持），配置为x64架构，和你的cpprestsdk版本匹配。
• 在这个DLL里封装好你需要的cpprestsdk功能，比如HTTP请求、JSON处理等，然后导出对应的函数接口（可以用__declspec(dllexport)）。
• 在你的CLR项目里，通过DllImport或者添加项目引用的方式调用这个DLL的接口。
  这样既保留了CLR项目的.NET交互能力，又能正常使用cpprestsdk的所有功能。

2. 尝试通过预编译宏禁用cpprestsdk的并发特性 #

有些版本的cpprestsdk支持通过宏定义关闭异步/并发相关功能，从而减少对<mutex>的依赖：

• 在CLR项目的属性 -> C/C++ -> 预处理器 -> 预处理器定义里，添加_CPPREST_NO_ASYNCHRONOUS_FUNCTIONS宏。
  不过要注意，这个宏会禁用cpprestsdk的异步API，比如http_client的异步请求功能，如果你只用到同步功能，这个方法可以一试，但适用性比较有限。

3. 升级Visual Studio版本 #

VS2017对CLR和现代标准库的兼容性确实一般，后续的VS2019/2022版本对CLR模式下的标准库支持有一定提升，虽然不能保证完全解决<mutex>的问题，但部分场景下可能能绕过这个错误。不过这个方案需要考虑项目迁移的成本，比如依赖的其他库是否兼容新版本VS。

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