FFmpeg中AVCodecContext成员访问的64位编译偏移问题求助

这问题我之前帮同事排查过类似的，大概率是结构体对齐规则不匹配或者FFmpeg库/头文件版本/位数不一致导致的，咱们一步步拆解可能的原因和解决方案：

1. 结构体对齐规则差异 #

32位和64位编译环境下，默认的结构体对齐策略（比如GCC的-m32/-m64选项）会因为指针大小（4字节 vs 8字节）的变化，改变结构体成员的内存偏移。如果你的代码里存在以下情况，很容易触发偏移错误：

• 手动计算过AVCodecContext成员的偏移（比如硬写offsetof的数值，或者用指针强制转换跳过结构体成员）
• 项目编译时的对齐选项和FFmpeg库编译时的对齐选项不一致

解决方案：

• 绝对不要手动计算成员偏移，直接使用FFmpeg官方定义的成员名（比如av_ctx->coded_width）访问
• 确保项目编译时的对齐选项和FFmpeg库一致：比如FFmpeg默认使用-fPIC和8字节/16字节对齐，你的项目编译参数要匹配，不要随意修改-pack-struct这类会改变对齐的选项

2. FFmpeg库的编译位数不匹配 #

最常见的坑：32位编译时用的是32位FFmpeg库，但64位编译时不小心链接了32位的库（或者反过来）。这种情况下，结构体的内存布局完全不兼容，成员偏移自然会错乱。

解决方案：

• 重新编译对应位数的FFmpeg库：64位项目必须链接64位编译的FFmpeg库文件（.so/.dll/.a）
• 检查项目的链接路径：把64位库的路径放在优先级最高的位置，避免误链接到32位的旧库

3. 头文件与库版本不匹配 #

如果你的代码包含的FFmpeg头文件版本，和实际链接的库版本不一致（比如头文件是FFmpeg 6.x，链接的却是4.x的库），AVCodecContext的结构体成员可能有增减或顺序调整，32位下可能碰巧对齐正常，64位就会暴露偏移错误。

解决方案：

• 确保头文件和库的版本完全一致：不管32位还是64位编译，都使用同一版本的FFmpeg
• 在代码中添加版本校验，避免版本 mismatch：

  #include <libavcodec/version.h>
  #if LIBAVCODEC_VERSION_MAJOR != 60 // 替换为你实际使用的版本号
  #error "FFmpeg codec version mismatch between headers and library!"
  #endif
  

4. 自定义扩展破坏结构体布局 #

如果你的代码对AVCodecContext做了非标准扩展（比如直接修改结构体、添加自定义字段，或者用非法的指针强制转换扩展），64位下指针大小的变化会直接打乱原结构体的成员偏移。

解决方案：

• 不要直接修改AVCodecContext结构体，使用FFmpeg提供的标准接口存储自定义数据：比如用av_dict_set、av_opt_set，或者通过avctx->priv_data（针对编码器/解码器私有数据）来扩展

调试技巧 #

可以在32位和64位环境下分别打印成员的偏移值，快速定位问题：

#include <stddef.h>
#include <libavcodec/avcodec.h>

// 在调试代码中添加
printf("coded_width offset (current arch): %zu\n", offsetof(AVCodecContext, coded_width));
printf("coded_height offset (current arch): %zu\n", offsetof(AVCodecContext, coded_height));

如果32位和64位输出的偏移值不一致，说明你的头文件或库的编译环境存在不匹配的问题。

我之前碰到的典型案例是同事在64位编译时误链接了32位的FFmpeg静态库，替换成64位库后问题立刻解决。你可以优先排查库的位数和版本匹配问题，这是最常见的触发点。

内容的提问来源于stack exchange，提问作者HMD