Ubuntu-Rockchip 项目构建过程中 rootfs/dev 挂载问题分析与解决

问题现象

在 Ubuntu-Rockchip 项目的构建过程中，当执行到 scripts/config-image.sh 脚本时，部分用户遇到了构建失败的情况。具体错误表现为系统无法挂载 rootfs/dev 目录，错误信息如下：

mount: rootfs/dev: mount point does not exist.
Error: in ./scripts/config-image.sh on line 86
Error: in ./build.sh on line 229

环境背景

该问题主要出现在 Ubuntu 22.04.04 虚拟机上构建项目时。Ubuntu-Rockchip 是一个针对 Rockchip 处理器的 Ubuntu 系统定制项目，需要构建完整的系统镜像。

原因分析

1. 依赖缺失：构建过程中缺少必要的工具链和依赖包，导致无法正确创建和挂载开发设备节点。

2. 目录结构问题：在构建过程中，rootfs 目录结构可能未能正确建立，导致挂载点不存在。

3. 权限问题：构建过程中可能因权限不足无法创建必要的设备节点和目录。

解决方案

完整依赖安装

确保安装所有必要的构建依赖包，这是最全面的解决方案：

sudo apt-get install -y build-essential gcc-aarch64-linux-gnu bison \
qemu-user-static qemu-system-arm qemu-efi u-boot-tools binfmt-support \
debootstrap flex libssl-dev bc rsync kmod cpio xz-utils fakeroot parted \
udev dosfstools uuid-runtime git-lfs device-tree-compiler python2 python3 \
python-is-python3 fdisk bc debhelper python3-pyelftools python3-setuptools \
python3-distutils python3-pkg-resources swig libfdt-dev libpython3-dev

替代方案

如果上述方法无效，可以尝试以下方法：

1. 重新克隆项目：有时本地仓库可能存在问题，重新克隆最新版本可能解决构建问题。

2. 手动创建目录：在构建前手动创建所需的目录结构：

   mkdir -p rootfs/dev
   

3. 使用 GitHub Actions：考虑使用项目的 GitHub Actions 进行构建，避免本地环境差异导致的问题。

预防措施

1. 环境一致性：建议使用与项目推荐一致的构建环境，避免因系统版本差异导致的问题。

2. 构建前检查：在开始构建前，运行依赖检查脚本或命令，确保所有必要组件已安装。

3. 日志分析：构建失败时，仔细查看完整构建日志，定位具体失败点。

技术原理

在 Linux 系统构建过程中，/dev 目录包含所有设备文件节点。在构建嵌入式系统镜像时，需要正确设置这些设备节点以便系统能够访问硬件设备。当构建系统尝试挂载这个目录时，如果目录不存在或权限不正确，就会导致构建失败。

总结

Ubuntu-Rockchip 项目的构建过程涉及复杂的系统镜像创建，对构建环境有较高要求。遇到 rootfs/dev 挂载问题时，首先应确保所有构建依赖已正确安装。如果问题仍然存在，可以考虑重新获取项目代码或使用云端构建环境。理解构建过程中设备节点创建的原理，有助于快速定位和解决类似问题。