Boost.Asio 是基于 reactor 模式与线程池的跨平台异步 I/O 库，核心为 iocontext、socket 和 async* 操作；需确保 socket 生命周期、避免 handler 耗时、正确处理 error_code 与缓冲区，并注意多线程下共享资源安全。
Boost.Asio 是 C++ 中成熟、跨平台的异步 I/O 库，特别适合编写高性能网络服务（如 HTTP 服务器、实时通信网关等）。它不依赖操作系统原生异步接口（如 Linux 的 epoll 或 Windows 的 IOCP），而是通过统一的 reactor 模式 + 线程池抽象，让你用一致的 API 处理同步/异步操作。
核心概念：io_context、socket 和 async_* 操作
所有异步操作围绕 boost::asio::io_context 展开——它是事件循环的核心，负责分发完成事件。你需要创建 socket（如 tcp::socket 或 udp::socket），并调用 async_connect、async_read、async_write 等函数发起非阻塞操作。每个异步调用都接受一个可调用对象（lambda、函数对象或绑定后的函数）作为完成处理器（completion handler），当 I/O 完成时由 io_context::run() 自动调用。
- 不要在 completion handler 中直接做耗时操作（如文件写入、复杂计算），否则会阻塞事件循环；应将任务投递到线程池或用
post()延迟执行 - socket 必须在 handler 执行期间保持有效（不能被析构或移动）；常用做法是把 socket 和 buffer 封装进一个连接类（如
session），用shared_ptr管理生命周期 - 每次
async_read需指定缓冲区大小或使用dynamic_buffer，避免读取不完整或越界
典型 TCP 服务器结构（单线程+async_accept）
一个轻量级服务器通常从 async_accept 开始，每接受一个连接就创建一个 session 对象，负责后续读写。关键点在于“链式异步”：读完一次后立即发起下一次 async_read，形成持续监听循环。
- 监听 socket 调用
acceptor.async_accept(socket, handler)，handler 中检查错误，成功则构造session{std::move(socket)}并启动session.start() -
session::start()内部调用async_read，读到数据后解析、处理，再调用async_write发送响应；write 完成后再立刻调回async_read，维持连接活跃 - 使用
boost::asio::buffer(data, size)包装原始内存，或用std::array<char></char>作栈上缓冲区，减少堆分配
多线程安全与资源管理
io_context 本身不是线程安全的，但可以被多个线程同时调用 run()（即“worker threads”模式）。此时所有 handler 可能并发执行，需注意：
立即学习“C++免费学习笔记（深入）”；
- 共享数据（如全局连接计数、session 列表）必须加锁（
std::mutex）或改用无锁结构（如boost::lockfree::queue） - 避免跨线程直接操作 socket；如果必须，可用
io_context::post()把操作调度回 io_context 所在线程执行 - 主动关闭连接时，先调
socket.close()，再确保所有 pending 的 async 操作已取消（socket.cancel()可触发 handler 以error::operation_aborted返回）
常见陷阱与调试建议
Asio 异步模型容易因生命周期或错误处理疏忽导致崩溃或资源泄漏：
- 忘记检查 handler 中的
error_code参数：即使连接断开，async_read仍会完成，但 error_code 非零，需判断是否继续读 - 缓冲区复用错误：同一个
std::vector<char></char>被多次传给async_read而未清空或 resize，导致数据覆盖 - 调试时启用 Asio 日志：定义
BOOST_ASIO_ENABLE_HANDLER_TRACKING，编译后运行会输出 handler 创建/调用轨迹，配合strace或 Wireshark 定位卡顿点
