gsoap 是最省事的 soap 客户端方案，但默认配置不启用 https、不校验证书、不设超时，易导致上线故障；需加 -c/-c 参数生成代码，调用 soap_ssl_init()、设置超时、正确处理 wsdl binding 类型与命名空间，并链接 gsoapssl 库及匹配 openssl 版本。
gSOAP 是目前最省事的选择，但默认配置会踩坑
直接用 gSOAP 生成客户端代码是主流做法，不是因为它多优雅，而是手写 XML+HTTP+SSL 处理太容易出错。但默认的 wsdl2h 和 soapcpp2 生成的代码，默认不启用 HTTPS、不校验证书、不设超时，上线后常连不上或卡死。
-
wsdl2h -c -o service.h https://example.com/service?wsdl：加-c生成 C 风格接口（更稳定），避免 C++ 异常干扰 -
soapcpp2 -C -I /path/to/gsoap/import service.h：加-C只生成客户端，-I指向import/目录（否则stdstring.h找不到） - 生成的
soap_init()后必须调用soap_ssl_init()，否则 HTTPS 直接失败，错误是SOAP_SSL_ERROR - 设置超时：在
struct soap *soap = soap_new()后立刻加soap->send_timeout = 10;和soap->recv_timeout = 30;
手动发 SOAP 请求前，先确认 WSDL 的 binding 类型
不是所有 WSDL 都能用 POST + XML 走通。如果 WSDL 里 <binding></binding> 的 transport 是 http://schemas.xmlsoap.org/soap/http，那可以手撸；但如果是 https://schemas.xmlsoap.org/wsdl/soap12/ 或带 style="document" + use="literal"，手写 XML 极易格式错位，SOAP-ENV:Client 错误频出。
- 用
curl -s "https://example.com/service?wsdl" | grep -A5 "<binding> 快速看 binding 类型</binding> - 手动构造时，
Content-Type必须是text/xml; charset=utf-8（不是application/soap+xml，后者是 SOAP 1.2，gSOAP 默认也不用它） - SOAP Action 头不能漏：
SOAPAction: "http://tempuri.org/MethodName"，值得从 WSDL 的<operation></operation>里找soapAction属性 - XML 命名空间必须和 WSDL 完全一致，少一个
xmlns:tns="..."就返回SOAP-ENV:Client或空响应
gSOAP 编译链接时常见的符号未定义错误
错误像 undefined reference to 'soap_new' 或 'soap_ssl_client_context'，本质是没链对库，不是代码写错了。
- 必须链接
gsoapssl++（C++）或gsoapssl（C），不是只链gsoap++—— 否则 HTTPS 直接编译不过 - OpenSSL 版本要匹配：gSOAP 2.8.x 依赖 OpenSSL 1.1.x，若系统是 OpenSSL 3.x，得自己编译 gSOAP 源码并加
-DWITH_OPENSSL3 - Linux 下用
pkg-config --libs gsoapssl++查真实链接参数，别硬写-lgsoapssl++，缺-lssl -lcrypto也会报错 - Windows 上若用 MinGW，确保
libws2_32.a被链接，否则connect()相关符号找不到
调试 SOAP 请求时，别信服务端返回的“成功”响应
很多 SOAP 服务在 HTTP 层返回 200，但实际 body 里是 <fault></fault>。gSOAP 默认不抛异常，soap_call_XXX() 返回 0 只代表网络层 OK，不代表业务逻辑成功。
立即学习“C++免费学习笔记（深入）”；
- 每次调用后检查
soap->error：非 0 表示底层错误（如连接超时）；为 0 但响应含 Fault，得手动查soap->fault是否非空 - 开启日志最简单：
soap_set_logfile(soap, "soap.log"); soap_set_recv_logfile(soap, "soap.log");，比抓包快得多 - WSDL 中定义的 fault 类型（如
MyServiceFault）会被生成进头文件，但不会自动解析进soap->fault，得用soap_lookup_fault(soap)手动映射
真正麻烦的从来不是调通，而是服务端悄悄改了 WSDL 里的命名空间或字段类型，而你的本地头文件没更新——这种问题不会报编译错，只会在某次生产调用里静默丢数据。
