Dockerfile中执行cmake、make无效果的问题排查求助

我的Dockerfile内容如下：

WORKDIR /my_ws 

# clone opencv
RUN git clone https://github.com/opencv/opencv.git
    
# clone opencv_contrib
RUN git clone https://github.com/opencv/opencv_contrib.git

# build opencv
WORKDIR /my_ws/opencv 
RUN sudo mkdir -p /my_ws/opencv/build
WORKDIR /my_ws/opencv/build
RUN cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=$(python3 -c "import sys; print(sys.prefix)") -D PYTHON3_EXECUTABLE=$(which python3) -D PYTHON_DEFAULT_EXECUTABLE=$(which python3) -D WITH_GTK=ON -D WITH_FFMPEG=ON -D BUILD_EXAMPLES=ON -D INSTALL_C_EXAMPLES=OFF -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules -D INSTALL_PYTHON_EXAMPLES=ON -D HAVE_opencv_python3=ON .. &> cmake.log
RUN make -j4 &> make.log
RUN make install &> make-install.log

WORKDIR /my_ws 

使用以下命令构建镜像：

docker build . --no-cache --progress plain -t my_co:my_prod &> docker-build.log

docker-build.log中的关键内容：

#11 [11/44] WORKDIR /my_ws
#11 DONE 0.0s

#12 [12/44] RUN git clone https://github.com/opencv/opencv.git
#12 0.321 Cloning into 'opencv'...
#12 DONE 36.5s

#16 [13/44] RUN git clone https://github.com/opencv/opencv_contrib.git
#16 0.463 Cloning into 'opencv_contrib'...
#16 DONE 9.7s

#27 [14/44] WORKDIR /my_ws/opencv
#27 DONE 0.0s

#28 [15/44] RUN sudo mkdir -p /my_ws/opencv/build
#28 DONE 0.3s

#29 [16/44] WORKDIR /my_ws/opencv/build
#29 DONE 0.0s

#30 [17/44] RUN cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=$(python3 -c "import sys; print(sys.prefix)") -D PYTHON3_EXECUTABLE=$(which python3) -D PYTHON_DEFAULT_EXECUTABLE=$(which python3) -D WITH_GTK=ON -D WITH_FFMPEG=ON -D BUILD_EXAMPLES=ON -D INSTALL_C_EXAMPLES=OFF -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules -D INSTALL_PYTHON_EXAMPLES=ON -D HAVE_opencv_python3=ON .. &> cmake.log
#30 DONE 0.5s

#31 [18/44] RUN make -j4 &> make.log
#31 DONE 0.4s

#32 [19/44] RUN make install &> make-install.log
#32 DONE 0.4s

运行容器命令：

docker run -d --name my_container my_co:my_prod 

进入容器检查后发现，/my_ws/opencv/build下只有空的日志文件，没有任何构建产物：

*  Executing task: docker exec -it 572d39fd1653a9f54d848e2936aabc4a7d13b93a661538b20fb09156e5570351 bash 

root@572d39fd1653:/my_ws# cd ./opencv/build/
root@572d39fd1653:/my_ws/opencv/build# ls
cmake.log  make-install.log  make.log
root@572d39fd1653:/my_ws/opencv/build# cat cmake.log 
root@572d39fd1653:/my_ws/opencv/build# cat make-install.log 
root@572d39fd1653:/my_ws/opencv/build# cat make.log 
root@572d39fd1653:/my_ws/opencv/build# 

但手动在容器内执行相同的cmake、make、make install命令时，能正常生成构建产物并写入日志。基础镜像为Ubuntu20.04，请问为何Dockerfile构建时OpenCV未正常执行？

核心原因 #

1. sudo权限冗余导致异常：Docker构建过程默认以root用户执行所有RUN命令，不需要添加sudo。使用sudo会触发非root环境执行后续逻辑，可能因权限限制、环境变量缺失，导致cmake/make命令静默失败，甚至根本没启动。
2. 日志重定向掩盖错误：&> cmake.log会将标准输出和错误都写入日志，但如果命令本身未正常执行（比如cmake因权限问题未启动），日志文件会被创建但内容为空。而Docker仅检查命令的退出码，sudo本身执行成功的话，退出码为0，构建就会标记为完成，不会暴露内部错误。
3. 构建时长暴露问题：从日志看cmake、make、make install都只用了0.4-0.5秒，这完全不符合OpenCV构建的实际耗时，说明这些命令根本没真正执行，只是快速退出了。

解决步骤 #

• 移除所有sudo：直接执行mkdir -p /my_ws/opencv/build即可，Docker构建默认是root用户，无需额外提权。
• 临时取消日志重定向：先去掉&> cmake.log这类重定向，让命令输出直接显示在构建终端，方便排查具体错误。确认构建正常后，再重新添加日志重定向。
• 强制检查命令执行状态：可以在RUN命令后添加|| exit 1，确保命令失败时构建直接终止，避免隐藏问题。

修改后的Dockerfile关键部分示例：

# build opencv
WORKDIR /my_ws/opencv 
RUN mkdir -p /my_ws/opencv/build
WORKDIR /my_ws/opencv/build
# 先取消日志重定向，排查问题
RUN cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=$(python3 -c "import sys; print(sys.prefix)") -D PYTHON3_EXECUTABLE=$(which python3) -D PYTHON_DEFAULT_EXECUTABLE=$(which python3) -D WITH_GTK=ON -D WITH_FFMPEG=ON -D BUILD_EXAMPLES=ON -D INSTALL_C_EXAMPLES=OFF -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules -D INSTALL_PYTHON_EXAMPLES=ON -D HAVE_opencv_python3=ON .. || exit 1
RUN make -j4 || exit 1
RUN make install || exit 1

额外建议 #

• 构建前确保基础镜像已安装依赖：比如build-essential、cmake、python3-dev、libgtk-3-dev、ffmpeg等必要包，否则cmake会因缺失依赖而失败。
• 保持--progress plain参数，它会显示更详细的命令执行输出，帮助快速定位问题。

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