Yocto构建报错：两配方重复安装scsi_ioctl.h触发sysroot冲突

1. scsi_ioctl.h重复安装的来源定位 #

bitbake在do_prepare_recipe_sysroot阶段的冲突检查是强制保护机制，目的是避免同一文件路径被不同配方的不同版本覆盖、导致头文件与库版本不匹配的隐性问题，发现跨配方文件归属重复时会直接中止流程。两个配方的文件来源拆解如下：

• linux-libc-headers侧的文件来源：该配方执行oe_runmake headers_install时，会将内核uapi子系统导出的所有用户态头文件安装到目标路径，其中就包含include/scsi/scsi_ioctl.h。它的do_install流程仅主动删除了同目录下的scsi.h，未对scsi_ioctl.h做排除，因此该文件会被正常打包到linux-libc-headers的sysroot组件中，这一点也能从报错日志里验证——在sysroots-components/aarch64/linux-libc-headers路径下确实存在这个文件。
• glibc-initial侧的文件来源：glibc源码树本身内置了scsi相关的兼容头文件，位置在源码目录的sys/scsi/子路径下（之前搜索没找到是因为检索范围只覆盖了源码根目录，没有递归遍历所有源码子目录）。在执行install-bootstrap-headers=yes install-headers的安装步骤时，glibc会将这些内置头文件一并安装到目标${includedir}/scsi/路径下。正常版本的glibc配方会通过补丁机制，在do_install流程最后主动删除这些和linux-libc-headers重复的头文件，但如果补丁丢失/失效，这些文件就会被留在glibc-initial的安装目录中，等bitbake准备sysroot时就会触发冲突检查。
• 触发冲突的版本错位原因：Yocto 2.27（Rocko）官方版本组合中，glibc对应配套的linux-libc-headers（4.15版本）会通过专属补丁将scsi_ioctl.h从内核头文件导出列表中排除，两个配方根本不会同时安装同一个文件。当自定义修改了linux-libc-headers的版本（比如替换成了更高版本的内核头文件，或者误用了自定义内核的源码），原有的排除补丁不生效，就会把scsi_ioctl.h安装出来，和glibc侧的内置文件形成归属冲突。

2. 报错路径与本地MACHINE配置不匹配的成因 #

这属于对Yocto目录结构的常见认知偏差，不是配置异常：

• Yocto的work路径生成规则是${TMPDIR}/work/${TARGET_SYS}/${BPN}/${PV}-${PR}，其中TARGET_SYS是目标三元组（格式为arch-vendor-os，对poky工具链来说就是aarch64-poky-linux），不是local.conf中配置的MACHINE值。
• MACHINE强相关的构建内容（比如内核、U-Boot、板级设备树）会存放在${TMPDIR}/work-shared/${MACHINE}/路径下，和通用架构层的配方工作目录是完全分离的。
• 只要是aarch64架构、使用poky工具链的构建，不管MACHINE配置是qemuarm64还是其他自定义板型，glibc这类通用系统配方的工作目录都会落在work/aarch64-poky-linux/路径下，和日志里的路径完全一致，不属于配置错误。

快速验证步骤 #

• 检索两个配方的实际安装清单，确认文件来源：
• 查看linux-libc-headers的安装清单：进入其工作目录tmp/work/aarch64-poky-linux/linux-libc-headers/，在installed-package-manifest.txt中搜索scsi_ioctl.h，确认其确实在安装列表中。
• 查看glibc-initial的安装清单：进入glibc的工作目录，同样检索已安装文件列表，确认scsi_ioctl.h是glibc自身do_install生成的文件；同时在glibc源码目录下执行find . -name scsi_ioctl.h，定位到源码内置的对应文件。
• 检查补丁完整性：查看当前使用的glibc2.27配方的补丁集，确认是否存在“删除和linux-libc-headers重复scsi头文件”的补丁，这类补丁的逻辑通常是在do_install末尾执行rm -f ${D}${includedir}/scsi/scsi_ioctl.h。如果补丁丢失，就是冲突的直接触发原因。

修复方案 #

• 临时快速修复：在glibc-initial的do_install流程末尾添加一行删除重复文件的逻辑，避免glibc-initial安装该冲突文件：

rm -f ${D}${includedir}/scsi/scsi_ioctl.h

• 根因修复：检查当前使用的linux-libc-headers是否为Yocto 2.27版本对应的官方主线版本，按照配方内置注释的说明，不要使用自定义内核的源码构建linux-libc-headers——这类自定义内核的头文件往往没有同步主线的排除规则，会把不应导出的scsi_ioctl.h安装到系统路径，引发冲突。如果需要自定义内核驱动的专用头文件，按照注释说明从STAGING_KERNEL_DIR路径获取，不要修改libc关联的头文件来源。
• 关于路径的认知修正：不需要修改local.conf的MACHINE配置，日志中的路径是Yocto默认生成的标准路径，可通过执行bitbake -e glibc | grep ^WORKDIR确认路径生成逻辑符合默认规则。

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