Yocto构建依赖缓存异常：首次无缓存/重建挂起求助

一、验证缓存有效性 #

• 检查缓存目录挂载路径：Yocto的sstate-cache和downloads必须挂载到WSL2内部的Linux文件系统，禁止挂载Windows NTFS路径（/mnt/c/xxx这类）。NTFS与Linux文件系统的兼容性问题会导致缓存读写失败、重启后缓存丢失。查看Docker启动命令或Compose文件中的-v参数，确保挂载路径为WSL内部路径（如/home/user/yocto-sstate）。
• 校验缓存完整性：
  1. 进入容器执行bitbake -c cleansstate core-image-base，删除sstate-cache中对应目标的缓存文件，再单独构建一个轻量包（如bitbake bash），观察是否能正常复用其他缓存且无挂起。
  2. 检查缓存目录权限：执行ls -ld /path/to/sstate-cache，确保容器内构建用户拥有读写权限，权限错误会导致缓存加载卡住，必要时用chown -R build:build /path/to/sstate-cache修正。
• 测试无缓存构建：删除整个sstate-cache目录，重新启动构建。若能正常完成，说明原缓存文件存在损坏。

二、排查性能瓶颈 #

• 调整WSL2资源分配：
  1. 在Windows用户目录下创建/修改.wslconfig文件，分配足够资源（Yocto构建建议至少8核、16GB内存）：

     [wsl2]
     memory=16GB
     processors=8
     swap=4GB
     localhostForwarding=true
     

  2. 执行wsl --shutdown后重启WSL2生效。
• 监控系统负载：
  1. 在WSL2终端运行htop，同时启动构建，观察CPU、内存、磁盘IO占用。若磁盘IO持续满负载，说明WSL2虚拟磁盘性能不足，可临时将sstate-cache挂载到WSL2的/tmp（内存文件系统）测试，看是否解决挂起问题。
  2. 检查Docker存储驱动：执行docker info | grep Storage Driver，确保使用overlay2驱动，vfs驱动性能极差会导致构建卡顿。
• 跨环境对比测试：在纯Linux虚拟机中使用相同Docker配置构建，若正常则说明问题源于WSL2的性能或兼容性。

三、额外排查项 #

• 确认分支兼容性：确保yocker与meta-bsp-imx8mp的分支版本匹配，分支不兼容可能引发缓存逻辑异常。
• 重置Docker环境：执行docker system prune -a清理无用镜像与容器，重新拉取Compulab官方Docker镜像，排除镜像本身的问题。

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