C++如何使用std::stop_callback在取消请求时执行资源清理-C++-PHP中文网

std::stop_callback是c++20协作取消机制中用于自动触发清理逻辑的关键工具，必须在需响应停止请求并执行资源释放的场景（如长时i/o、循环计算或条件变量等待）中使用。

c++如何使用std::stop_callback在取消请求时执行资源清理

std::stop_callback 是什么，它在什么场景下必须用

std::stop_callback 是 C++20 引入的协作式取消机制中的关键工具，用于在 std::stop_source 发出停止请求（request_stop()）后，**自动触发一段清理逻辑**。它不是“主动轮询”或“中断线程”，而是依赖调用方显式检查停止状态（如 stop_token::stop_requested()）并配合回调执行资源释放——典型场景是：线程正在做长时间 I/O、循环计算或等待条件变量，且需要在被取消时及时关闭文件句柄、释放内存、注销监听器等。

如何正确构造和绑定 stop_callback 到 stop_token

构造 std::stop_callback 必须传入一个有效的 std::stop_token 和一个可调用对象（lambda、函数对象等），且该 token 必须来自同一个 std::stop_source（否则行为未定义）。常见错误是把 token 从不同 source 复制过来，或在 token 已失效（如所属 std::jthread 已退出）后仍尝试构造。

std::stop_callback 的生命周期由其自身管理：一旦构造成功，它会自动注册；析构时自动反注册（无需手动调用）
回调函数不能抛异常，否则程序直接终止（C++ 标准强制要求 noexcept）
回调执行期间，std::stop_source 可能已被销毁，因此避免捕获外部 std::stop_source 或 std::jthread 的引用

示例：

std::stop_source ss;
std::stop_token st = ss.get_token();
auto cb = std::stop_callback(st, []() noexcept {
    // 清理逻辑：close(fd), delete ptr, etc.
}); // 构造即注册

为什么 stop_callback 不能替代 stop_token::stop_requested() 检查

std::stop_callback 只负责“响应取消请求”，不提供“是否已请求”的查询能力。很多用户误以为注册了 callback 就万事大吉，结果发现资源没及时释放——因为 callback 只在 request_stop() 被调用后才执行，而线程可能卡在某个无检查的循环里，根本没机会触发 callback（callback 执行本身不中断线程）。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

必须在循环体、阻塞调用前后插入 if (token.stop_requested()) break; 或类似逻辑
阻塞 API（如 std::condition_variable::wait）应优先使用带 stop_token 的重载版本（如 wait(lock, pred, st)），它们内部会自动检查并提前返回
callback 适合做“兜底清理”，比如确保即使主循环因异常跳过检查，也能释放关键资源

std::jthread 自动管理 stop_source，但 stop_callback 仍需手动控制生命周期

使用 std::jthread 时，其内置的 std::stop_source 会在析构时自动调用 request_stop()，这看似省事，但容易忽略 std::stop_callback 对象本身的生存期——如果 callback 是局部变量，它会在 jthread 启动的函数作用域结束时先析构，从而提前反注册，导致后续取消时清理逻辑不执行。