FFmpeg的avcodec_send_packet()和avcodec_receive_frame()非线程安全，同一AVCodecContext*不可被多线程并发调用；正确做法是每线程独占一套编解码资源，或启用thread_count由FFmpeg内部线程池调度。
为什么不能直接用 std::thread 跑 FFmpeg 编解码循环
因为 FFmpeg 的 avcodec_send_packet() 和 avcodec_receive_frame() 不是线程安全的——同一 AVCodecContext* 实例不能被多个线程并发调用。常见错误是开多个 std::thread 共享一个解码器上下文，结果触发断言失败或随机崩溃，错误信息通常是 Assertion failed: atomic_load(&c->internal->buffered_packets_cnt) >= 0 或 segfault 在 ff_thread_decode_frame 内部。
正确做法是：每个线程独占一套编解码资源（AVCodecContext + AVCodec + 相关缓冲），或者用 FFmpeg 自带的多线程选项（如 thread_count）交由其内部线程池调度。
- 若需多路视频并行处理（如 4 路 IPC 流），每路分配独立
AVCodecContext+ 独立std::thread - 若单路视频想加速解码（如 1080p@60fps），优先启用
avctx->thread_count = 4+avctx->thread_type = FF_THREAD_FRAME，让 FFmpeg 自己做帧级并行 - 切勿在多个线程中混用同一个
av_packet_unref()/av_frame_free()操作同一对象
如何安全地在线程间传递 AVFrame 数据
直接 std::move 或裸指针传递 AVFrame* 极易出错：一帧内存可能被前一个线程 av_frame_unref() 后，后一个线程还试图读取 YUV 数据。必须明确所有权转移边界。
推荐用 std::shared_ptr 包装，并在构造时绑定自定义 deleter：
立即学习“C++免费学习笔记（深入）”；
auto frame_deleter = [](AVFrame* f) {
if (f) { av_frame_free(&f); }
};
using FramePtr = std::shared_ptr<AVFrame>;
FramePtr make_frame_ptr() {
auto f = av_frame_alloc();
return FramePtr(f, frame_deleter);
}
- 每次从解码器拿到新帧，都用
av_frame_ref()复制元数据和引用计数，再包装进新FramePtr - 编码线程拿到
FramePtr后，可安全读像素、调用sws_scale()、送入avcodec_send_frame() - 避免跨线程共享
AVBufferRef*—— 即使是同一块显存，不同线程未同步释放会导致 CUDA/VAAPI 上下文异常
std::mutex 配合 AVPacket 队列时的典型死锁场景
当用 std::queue<AVPacket> 做生产者-消费者模型时，容易写出这样的代码：mutex.lock(); queue.push(packet); av_packet_unref(&packet); mutex.unlock(); —— 这里 av_packet_unref() 可能触发内部回调（尤其启用硬件解码时），而回调又尝试获取同一把锁，导致死锁。
根本原则：锁内只做最轻量的内存拷贝，所有 FFmpeg API 调用必须在锁外完成。
- 正确顺序：先
av_packet_ref()复制一份 packet 数据 → 锁内 push 拷贝体 → 锁外av_packet_unref()原始 packet - 队列类型建议用
std::deque<std::vector<uint8_t>>存储packet.data的副本，彻底避开AVPacket生命周期管理 - 若必须传完整
AVPacket，请用std::shared_ptr<uint8_t[]>管理 data 缓冲，AVPacket结构体本身栈分配、锁外构造
Windows 下 MinGW 编译时 pthread 与 win32 线程混用的问题
MinGW 默认链接 winpthreads，但 FFmpeg Windows 官方构建版（.dll）是用 MSVC + native win32 thread 编译的。当你在 C++ 代码中用 std::thread，而 FFmpeg 内部调用 CreateThread，两者线程局部存储（TLS）不兼容，可能导致 av_log() 输出乱码、errno 错乱，甚至 avcodec_open2() 返回 -1 且无明确错误。
解决方案只有两个：
- 全部统一用 MSVC 工具链（推荐 VS2019+ + vcpkg 安装 ffmpeg）
- 若坚持 MinGW，则必须从源码编译 FFmpeg，并配置
--enable-pthreads --disable-w32threads，确保其内部也走 pthread 路径 - 检查
avcodec_configuration()输出是否含w32threads—— 若有，说明你正在混用线程模型
硬件加速路径（如 QSV、D3D11VA）在这种混用下大概率直接失败，错误常为 AVERROR_EXTERNAL 且 av_err2str() 返回空字符串。
