Docker容器中Yocto构建环境repo init与sync执行后工作区为空的问题排查

我来帮你分析几个最可能的原因和对应的解决思路：

1. 容器启动时的卷挂载覆盖了workspace #

这是最容易踩的坑！如果你启动容器时用了类似下面的命令：

docker run -v /本地目录:/home/yocto/workspace ...

本地的空目录会直接覆盖容器内已经同步好源码的workspace，导致你看到目录为空。

解决方法：

• 要么避免挂载本地目录到workspace，直接使用容器内预同步的内容；
• 如果你需要挂载本地目录来持久化缓存数据，应该挂载到你已经配置的/mnt/sstate或/mnt/downloads目录，而不是覆盖核心的workspace。

2. Docker构建缓存跳过了repo同步步骤 #

Docker会缓存每一步RUN命令的执行结果，如果之前构建过这个镜像，后续重新构建时可能直接复用了旧的缓存，跳过了repo sync步骤，导致workspace没有内容。

解决方法：
重新构建镜像时加上--no-cache参数，强制重新执行所有步骤：

docker build --no-cache -t yocto-build .

3. repo同步的权限顺序问题 #

看你的Dockerfile，repo init和repo sync是在root用户下执行的，之后才通过chown把目录权限转给yocto用户。虽然理论上chown -R应该能处理所有文件，但偶尔会有repo生成的特殊权限文件导致权限继承异常。

解决方法：
调整Dockerfile的执行顺序，切换到yocto用户后再执行repo操作：

# 先切换到yocto用户，再进行repo相关操作
USER yocto
WORKDIR /home/yocto/workspace
# 配置yocto用户的git全局设置
RUN git config --global http.postBuffer 524288000
RUN git config --global core.compression 0
RUN git config --global http.maxRequests 5
RUN git config --global color.ui true
RUN git config --global user.email "yocto@dockerbot.local"
RUN git config --global user.name "docker BOT"
# 下载OpenSTLinux仓库
RUN repo init --depth=1 -u https://github.com/STMicroelectronics/oe-manifest.git -b refs/tags/openstlinux-6.6-yocto-scarthgap-mpu-v24.11.06
RUN repo sync
# 切换回root设置环境变量（环境变量可提前设置，这里仅为保持逻辑连贯）
USER root
ENV DISTRO=openstlinux-weston
ENV MACHINE=stm32mp25-disco
ENV EULA_stm32mp25disco=1
ENV SSTATE_DIR="/mnt/sstate"
ENV DL_DIR="/mnt/downloads"
# 切回yocto用户作为默认用户
USER yocto

这样repo操作直接以yocto用户执行，从根源避免权限调整带来的问题。

4. 检查构建日志确认repo同步是否成功 #

构建镜像时，仔细查看repo sync步骤的输出，确认有没有报错或者同步中断的信息。有时候repo同步会因为网络波动中途失败，但Docker不会主动终止构建（除非命令返回非零码），导致workspace内容不完整甚至为空。

解决方法：
重新构建时查看完整日志，如果发现同步失败，可以给repo sync加重试机制：

# 最多重试3次应对临时网络问题
RUN repo sync || repo sync || repo sync

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