一、问题描述

因为项目中使用了zlib_decompressor功能，所以代码引用如下：

#include <boost/iostreams/stream.hpp>
#include <boost/iostreams/filter/zlib.hpp>
#include <boost/iostreams/filtering_stream.hpp>
#include <boost/iostreams/device/file.hpp>

开发环境为：

（1）VS2022，使用MSVC版本14.3

（2）下载了最新版的boost版本1.87.0，zlib版本1.3.1

二、编译错误描述

error LNK2019: 无法解析的外部符号 "public: static void __cdecl boost::iostreams::zlib_error::check(int)" (?check@zlib_error@iostreams@boost@@SAXH@Z)，函数 "public: bool __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::filter(char const * &,char const *,char * &,char *,bool)" (?filter@?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA_NAEAPEBDPEBDAEAPEADPEAD_N@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: __cdecl boost::iostreams::detail::zlib_base::zlib_base(void)" (??0zlib_base@detail@iostreams@boost@@IEAA@XZ)，函数 "public: __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::zlib_compressor_impl<class std::allocator<char> >(struct boost::iostreams::zlib_params const &)" (??0?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA@AEBUzlib_params@23@@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: __cdecl boost::iostreams::detail::zlib_base::~zlib_base(void)" (??1zlib_base@detail@iostreams@boost@@IEAA@XZ)，函数 "int `public: __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::zlib_compressor_impl<class std::allocator<char> >(struct iostreams::detail::zlib_params const &)'::`1'::dtor$0" (?dtor$0@?0???0?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA@AEBUzlib_params@23@@Z@4HA) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: void __cdecl boost::iostreams::detail::zlib_base::before(char const * &,char const *,char * &,char *)" (?before@zlib_base@detail@iostreams@boost@@IEAAXAEAPEBDPEBDAEAPEADPEAD@Z)，函数 "public: bool __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::filter(char const * &,char const *,char * &,char *,bool)" (?filter@?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA_NAEAPEBDPEBDAEAPEADPEAD_N@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: void __cdecl boost::iostreams::detail::zlib_base::after(char const * &,char * &,bool)" (?after@zlib_base@detail@iostreams@boost@@IEAAXAEAPEBDAEAPEAD_N@Z)，函数 "public: bool __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::filter(char const * &,char const *,char * &,char *,bool)" (?filter@?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA_NAEAPEBDPEBDAEAPEADPEAD_N@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: int __cdecl boost::iostreams::detail::zlib_base::xdeflate(int)" (?xdeflate@zlib_base@detail@iostreams@boost@@IEAAHH@Z)，函数 "public: bool __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::filter(char const * &,char const *,char * &,char *,bool)" (?filter@?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA_NAEAPEBDPEBDAEAPEADPEAD_N@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: int __cdecl boost::iostreams::detail::zlib_base::xinflate(int)" (?xinflate@zlib_base@detail@iostreams@boost@@IEAAHH@Z)，函数 "public: bool __cdecl boost::iostreams::detail::zlib_decompressor_impl<class std::allocator<char> >::filter(char const * &,char const *,char * &,char *,bool)" (?filter@?$zlib_decompressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA_NAEAPEBDPEBDAEAPEADPEAD_N@Z) 中引用了该符号
error LNK2019: 无法解析的外部符号 "protected: void __cdecl boost::iostreams::detail::zlib_base::reset(bool,bool)" (?reset@zlib_base@detail@iostreams@boost@@IEAAX_N0@Z)，函数 "public: __cdecl boost::iostreams::detail::zlib_compressor_impl<class std::allocator<char> >::~zlib_compressor_impl<class std::allocator<char> >(void)" (??1?$zlib_compressor_impl@V?$allocator@D@std@@@detail@iostreams@boost@@QEAA@XZ) 中引用了该符号
error LNK2019: 无法解析的外部符号 "private: void __cdecl boost::iostreams::detail::zlib_base::do_init(struct boost::iostreams::zlib_params const &,bool,void * (__cdecl*)(void *,unsigned int,unsigned int),void (__cdecl*)(void *,void *),void *)" (?do_init@zlib_base@detail@iostreams@boost@@AEAAXAEBUzlib_params@34@_NP6APEAXPEAXII@ZP6AX22@Z2@Z)，函数 "protected: void __cdecl boost::iostreams::detail::zlib_base::init<class std::allocator<char> >(struct boost::iostreams::zlib_params const &,bool,struct boost::iostreams::detail::zlib_allocator<class std::allocator<char>,class std::allocator<char> > &)" (??$init@V?$allocator@D@std@@@zlib_base@detail@iostreams@boost@@IEAAXAEBUzlib_params@23@_NAEAU?$zlib_allocator@V?$allocator@D@std@@V12@@123@@Z) 中引用了该符号
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::default_compression" (?default_compression@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::deflated" (?deflated@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::default_strategy" (?default_strategy@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::stream_end" (?stream_end@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::finish" (?finish@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::no_flush" (?no_flush@zlib@iostreams@boost@@3HB)
error LNK2001: 无法解析的外部符号 "int const boost::iostreams::zlib::sync_flush" (?sync_flush@zlib@iostreams@boost@@3HB)

三、问题分析

搜索解决的过程中遇到了很多问题，学习记录一下

1、boost编译

1）下载源码，https://www.boost.org/users/download/ 或者 https://archives.boost.io/release/1.87.0/source/ 7z或者zip格式

2）下载解压后点击bootstrap.bat文件，双击运行会生成b2.exe

3）输入以下指令编译boost库

b2.exe install --prefix="D:\boost_1_87_0\x64" --build-type=complete --toolset=msvc-14.3 threading=multi --build-type=complete address-model=64

4）常用的b2指令，可略过不看

-j<n>：指定并行构建的线程数，n指线程数，例如-j4
--build-type=<type> ：指定编译类型，type可以是complete、minimal 中的一个，complete是指构建所有目标，包括库、测试和用例；minimal是构建最小目标
--clean ：清空编译结果，只会清楚临时编译的中间成果，包括stage，安装的成果不会被清除
--prefix=<path> ：指定安装路径，例如--prefix=d:/boost/install 该选项需配合install使用，例如：b2.exe install --prefix=<path>
--with-<module> ：只编译指定模块，例如--with-program_options 意思是只编译program_options模块，该选项可以出现多次
--without-<module> ：排除指定模块，例如--without-program_options 意思是编译时除了program_options模块其他都编译
--stage=<path> ：指定编译的临时目录，通常用于存放生成的成果文件
release or debug ：指定编译Release版本或Debug版本，默认的话是二者都生成，例如b2 release
address-model=<32|64> ：指定编译的位数，例如b2 address-model=64，就只生成64位的库
link=<static|shared> ：指定输出静态库或动态库
toolset=<msvc-14.1> ：如果有多个编译器版本，可以通过toolset指定

5）至此boost编译成功后,会得到include和lib目录。

但是。。。。

以上编译不包含zlib库、bzip2库等

所以此时引用boost库后会编译报错如下：

缺少libboost_zlib-vc143-mt-x64-1_87.lib

2、编译 libboost_zlib-vc143-mt-x64-1_87.lib

这一步也很容易，网上的说法很多，经尝试都能编译出libboost_zlib-XXXX库文件

（1）方式1： b2  install --prefix="D:\boost_1_87_0\2x64" --build-type=complete --toolset=msvc-14.3 threading=multi --build-type=complete address-model=64 -sBZIP2_SOURCE="D:\bzip2-1.0.8" -sZLIB_SOURCE="D:\zlib-1.3.1"

直接通过b2编译

（2）方式2：

        1）通过cmake创建zlib工程，然后通过VS2022编译，先ALL_BUILD，然后INSTALL，最后得到inclue和lib目录

        2）然后通过下面的代码，单独编译iostreams

b2 --with-iostreams -sZLIB_INCLUDE="D:\zlib-1.3.1\include" -sZLIB_LIBPATH="D:\zlib-1.3.1\lib"

        3）将ZLIB_SOURCE、ZLIB_INCLUDE、ZLIB_LIBRARY_PATH写入系统环境变量，经过尝试也能正常编译。

结论：libboost_zlib-vc143-mt-x64-1_87.lib文件很容易生成，能解决掉缺失lib库的错误，但是编译依旧报错！！！！

3、问题不在libboost_zlib-vc143-mt-x64-1_87.lib这个静态库文件

其实分析报错信息就能发现 boost::iostreams::zlib::XXXX ，说明是iostreams出现的错误，即 libboost_iostreams-vc143-mt-x64-1_87.lib 文件内缺少了zlib相关的符号。所以应该是b2编译iostreams没有将zlib编进去。

验证一下：

通过VS工具，运行：dumpbin /symbols "D:\libboost_iostreams-vc143-mt-x64-1_87.lib" > rlt.txt，检索发现该文件没有任何zlib相关的内容。

以下所有尝试都是为了b2在编译iostreams生成libboost_iostreams-vc143-mt-x64-1_87.lib 文件时，能够将zlib相关信息编译进去！

（1）官网的相关说法，https://www.boost.org/doc/libs/1_87_0/more/getting_started/windows.html#prepare-to-use-a-boost-library-binary

（2）进一步的，https://www.boost.org/doc/libs/1_87_0/libs/iostreams/doc/installation.html

（3）以上都提到了window环境下需要通过user-config.jam配置相关信息

（4）继续搜索：https://stackoverflow.com/questions/4937723/compiling-boost-with-zlib

（5）官网相关介绍，https://www.boost.org/doc/libs/1_87_0/tools/build/doc/html/index.html#bbv2.overview.configuration

（6）还有其它GitHub网页，等等，反复尝试编译，耗费了大量时间， libboost_iostreams-vc143-mt-x64-1_87.lib 文件始终如一(523kb)，没有任何改变！！！！！！！！！！！

四、解决办法

突然想到，自己编译不出来，可以使用别人编译好的。

官网地址：https://www.boost.org/users/download/

下载boost_1_87_0-msvc-14.3-64.exe即可。

结束。