解决 FFmpeg 处理 H.264 视频时因分辨率对齐导致的崩溃问题

解决 FFmpeg 处理 H.264 视频时因分辨率对齐导致的崩溃问题

在用 FFmpeg 开发视频播放器时，我遇到了一个棘手的问题：当处理某些 H.264 视频时，程序在调用 sws_scale 转换帧数据时崩溃，日志中出现类似 [h264] Reinit context to 1008x800, pix_fmt: yuv420p 的信息，但解码帧的宽度却始终显示为 1000，而不是 1008。经过一番调试和分析，我发现问题出在分辨率对齐上。本文将详细记录这个“坑”的起因、解决过程和最终方案。

---

问题描述

我在使用 FFmpeg 的 C API 开发一个基于 Qt 的视频播放器时，核心逻辑包括：

1. 用 avcodec_receive_frame 解码视频帧（AVFrame）。
2. 用 sws_scale 将解码后的 YUV 数据转换为 RGBA 格式。
3. 将结果填充到 QImage 中渲染。

初始代码在 initialize 函数中这样初始化 SwsContext：

int alignedWidth = (m_codecCtx->width + 3) & ~3; // 对齐到 4 的倍数
m_swsCtx = sws_getContext(
    m_codecCtx->width, m_codecCtx->height, m_co