Dockerfile中RUN colcon build失败但容器内执行正常的原因

两者核心差异 #

• Dockerfile中每个RUN指令都会启动一个独立的临时非交互shell进程执行命令，命令执行完成后进程直接销毁，当前进程内设置的环境变量、临时shell状态全部不会保留到后续的RUN步骤
• RUN指令默认使用非交互模式执行，不会加载用户目录下的.bashrc、系统profile等交互/登录shell才会读取的配置文件
• 手动通过docker run -it进入容器时，启动的是交互模式的bash进程，会自动加载.bashrc中预置的环境配置，且终端内执行的所有命令都在同一个shell进程中，设置的变量、source的脚本全程生效

对应Dockerfile片段的具体问题 #

1. 单独写RUN export IGNITION_VERSION=edifice完全无效：这个环境变量只在当前这行RUN的临时进程里存在，后续执行rosdep、colcon build的RUN进程完全读不到这个变量，ros_ign编译脚本无法定位对应版本的Ignition Gazebo依赖
2. 编译前未加载ROS2基础环境：安装ROS2时通常会把source /opt/ros/foxy/setup.bash写到.bashrc里，但RUN的非交互shell不会加载这个配置，colcon、cmake找不到ROS2的核心构建规则、依赖路径，直接导致编译失败
3. 单独执行RUN source ros_ign_bridge_ws/install/setup.bash同样无效：source操作只对当前RUN进程生效，后续步骤完全读不到桥接组件的环境配置；另外写入.bashrc的路径是相对路径，后续进容器如果工作目录变化，会出现找不到文件的错误

修正后的Dockerfile片段 #

# 用ENV设置全局环境变量，所有后续构建步骤、运行时容器都能读取
ENV IGNITION_VERSION=edifice
WORKDIR /root
RUN mkdir -p ros_ign_bridge_ws/src
RUN git clone https://github.com/osrf/ros_ign.git -b foxy ros_ign_bridge_ws/src
WORKDIR /root/ros_ign_bridge_ws
# 把source环境、依赖安装、编译操作合并到同一个RUN的同一个shell进程中执行，保证环境全程生效
RUN bash -c "source /opt/ros/foxy/setup.bash && \
    rosdep install -r --from-paths src -i -y --rosdistro foxy && \
    colcon build"
# 写入bashrc时使用绝对路径，避免工作目录变化导致source失败
RUN echo "source /root/ros_ign_bridge_ws/install/setup.bash" >> ~/.bashrc

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