如何让Yocto/Wic生成文件顺序固定的EXT4分区实现可复现构建？

核心原因 #

ext4文件系统默认使用随机哈希种子生成目录索引，加上Yocto打包rootfs时文件顺序不固定，导致两次内容完全一致的构建生成的分区校验和不同，无法触发RAUC的install-same跳过逻辑。

解决方案1：固定ext4分区的目录排序规则 #

在你的.wks分区配置文件中，给ext4格式的rootfs分区添加--mkfs-options参数，强制固定哈希种子并禁用随机化行为：

part rootfs --source rootfs --ondisk mmcblk --fstype=ext4 --mkfs-options="-E hash_seed=0"

• hash_seed=0：固定目录哈希计算的种子，确保不同构建中目录内文件的排序完全一致；
• 如果不需要ext4的dir_index优化（该特性会用哈希排序加速目录查找，但也是导致顺序随机的原因），可以追加-O ^dir_index参数，让文件按写入顺序排列。

解决方案2：强制Yocto按固定顺序打包rootfs #

Yocto生成rootfs时会先打包为tar文件，再由wic转换为ext4分区。通过修改tar的打包参数，让文件按字典序排序：
在local.conf或对应镜像的.bb文件中添加：

ROOTFS_TAR_ARGS = "--sort=name --owner=root:0 --group=root:0 --mtime='1970-01-01 00:00:00'"

• --sort=name：强制tar按文件名的字典序排序打包，确保写入ext4分区的文件顺序固定；
• --mtime：统一文件的修改时间（可复现构建的必要参数，避免时间戳差异影响校验和）；
• --owner/--group：固定文件的属主属组，消除不同构建环境的权限差异。

解决方案3：调整RAUC校验逻辑（可选） #

如果上述方法无法完全满足需求，可以修改RAUC的manifest文件，将校验方式从分区级改为文件级：

<image name="rootfs" checksum="file">
    <file>rootfs.ext4</file>
</image>

这种方式会基于文件本身的校验和判断，而非整个分区的校验和，不过需要确保RAUC版本支持该特性。

内容的提问来源于stack exchange，提问作者Tomáš Čikel