正确链接Poco库需按依赖顺序：Linux下-lPocoNet -lPocoFoundation，CMake用find_package+target_link_libraries；Windows静态链接需定义POCO_STATIC宏；HTTP超时与代理须手动设置；JSON解析须检查isEmpty()；Thread需join()且注意栈大小。
怎么在 C++ 项目里正确链接 Poco 库
不配对的链接顺序和缺失的依赖会导致 undefined reference 错误，尤其在 Linux 下最常见。Poco 是模块化设计，PocoFoundation 是所有模块的基座，必须最先链接；网络功能依赖 PocoNet，而 PocoNet 又隐式依赖 PocoFoundation 和 PocoUtil（如果用了配置或日志）。
- Linux 下用
g++编译时，库顺序不能颠倒：-lPocoNet -lPocoFoundation有效，-lPocoFoundation -lPocoNet会失败 - CMake 中推荐用
find_package(Poco REQUIRED Net Foundation)，再通过target_link_libraries(myapp PRIVATE Poco::Net Poco::Foundation)自动处理依赖顺序和路径 - Windows 上若用静态编译，需定义
POCO_STATIC宏，否则链接器找不到符号（尤其是Poco::Net::HTTPClientSession这类类的 vtable）
HTTP 请求发不出去？检查 Poco::Net::HTTPClientSession 的超时和代理设置
默认情况下 Poco::Net::HTTPClientSession 没有设置连接/接收超时，遇到网络卡顿会无限阻塞；另外它不自动读取系统代理，需要手动配置。
- 务必显式调用
setConnectionTimeout()和setTimeout()，例如：session.setTimeout(Poco::Timespan(10, 0)); - 如需走代理，不能只设环境变量，得手动创建
Poco::Net::HTTPProxyAgent并传给HTTPClientSession构造函数 - 注意：HTTPS 请求默认不验证证书，生产环境必须调用
setInvalidCertificateHandler()并传入自定义校验逻辑，否则中间人攻击风险真实存在
Poco::JSON::Parser 解析失败但没报错？看清楚返回值和异常边界
Poco::JSON::Parser 的 parse() 方法返回 Poco::Dynamic::Var，但它不抛异常——解析失败时返回空 Var（即 var.isEmpty() 为 true），而不是 throw。很多开发者直接用结果当 Object::Ptr 强转，结果触发段错误。
- 安全写法是先判断：
if (result.isEmpty()) { /* 解析失败 */ } - 如果输入可能含 BOM 或非 UTF-8 编码，
parse()会静默失败，建议提前用Poco::TextEncoding::convert()清洗输入字符串 - 对大 JSON（>1MB），
Parser默认使用递归下降，深度过大会栈溢出；可改用Poco::JSON::Query配合流式解析，或限制setMaxNestingLevel()
为什么 Poco::Thread 启动后立刻退出？生命周期管理是关键
Poco::Thread 对象本身不持有线程资源，它只是个句柄；线程函数执行完就结束，但 Thread 对象若被析构，而底层线程还在跑，行为未定义。
立即学习“C++免费学习笔记（深入）”；
- 必须确保线程函数执行完毕后再调用
join()，不能只靠作用域自动析构 - 避免在线程函数里捕获局部对象引用——比如把
std::string成员变量的引用传进 lambda，对象可能已在主线程中销毁 - 更稳妥的做法是用
Poco::Runnable+Poco::Thread组合，由Runnable管理状态，Thread只负责调度
跨平台时特别注意：macOS 的 pthread 实现对栈大小敏感，Poco::Thread 默认栈仅 64KB，递归或大局部变量容易栈溢出，得用 setStackSize() 显式调大。
