如何正确为sysroot内的C头文件打补丁修复编译错误

完全适合，这也是该场景下唯一合规的正式修复方案。绝对不要直接修改sysroot下的硬链接文件：sysroot内的文件全部硬链接指向全局sstate共享缓存，直接修改会污染公共缓存，意外影响其他同环境下的构建任务，且一旦执行构建清理、重新拉取sstate缓存，修改就会直接丢失，完全不可追溯。

你遇到的编译报错本质是头文件里的__reserved命名和编译器内置保留宏冲突，临时手改硬链接只适合本地一次性验证，完全不适合正式交付场景。

sysroot是构建过程中由各个组件recipe自动部署生成的，补丁不能直接打在已生成的sysroot文件上，要打在提供该头文件的上游recipe上：

1. 定位头文件所属recipe
   在构建环境下执行命令，确认提供/usr/include/linux/stat.h的组件：

   oe-pkgdata-util find-path /usr/include/linux/stat.h
   

   常规环境下返回结果为linux-libc-headers，如果你用的是厂商定制的内核头文件包，替换成返回的对应recipe名即可。
2. 在自定义层添加补丁
   不要直接修改构建系统内置的源层，在你自己的项目自定义层中扩展对应recipe：
   • 以linux-libc-headers为例，在自定义层下创建recipes-kernel/linux-libc-headers/目录，新建linux-libc-headers_%.bbappend文件
   • 在该目录下新建files子目录，放入格式正确的补丁文件，补丁核心修改就是将冲突的__s32 __reserved;替换为__s32 reserved;，补丁参考内容：

     --- a/include/uapi/linux/stat.h
     +++ b/include/uapi/linux/stat.h
     @@ -56,7 +56,7 @@ struct statx {
      	__u32 stx_attributes_mask;
      	struct statx_timestamp stx_atime;
      	struct statx_timestamp stx_btime;
     -	__s32 __reserved;
     +	__s32 reserved;
      };
     

   • 编辑bbappend文件，将补丁加入组件的构建源码源列表：

     FILESEXTRAPATHS:prepend := "${THISDIR}/files:"
     SRC_URI += "file://0001-fix-stat-h-reserved-macro-conflict.patch"
     

3. 重新生成sysroot生效
   执行命令清理旧的组件构建产物，重新部署sysroot：

   bitbake -c clean linux-libc-headers
   bitbake linux-libc-headers
   bitbake -c populate_sysroot linux-libc-headers
   

   操作完成后再编译你的应用即可正常通过，该修改随自定义层做版本管理，不会污染公共缓存，全量重建、换构建目录都不会丢失。

如果只是本地快速验证不想写补丁，也不要直接修改硬链接文件：先执行rm删除sysroot路径下的stat.h硬链接，再把修改后的头文件复制到原路径，这种操作只会修改当前构建目录下的文件，不会影响sstate公共缓存，但仅适合临时调试用，正式场景必须走recipe打补丁的流程。

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