Docker使用rocker/r-ver渲染RMarkdown PDF报错：pdflatex未找到

问题背景 #

在Mac Version 12.6.1系统的Linux环境下，使用rocker/r-ver:4.2.2镜像构建Docker容器渲染RMarkdown PDF，执行docker build . -t analysis时出现编译失败，核心错误信息为：

! sh: 1: pdflatex: not found
Error: LaTeX failed to compile Paper.tex.

原Dockerfile内容：

FROM rocker/r-ver:4.2.2
RUN apt-get update \
  && apt-get install -y --no-install-recommends \
   wget \
   graphviz \
   perl && \
   /rocker_scripts/install_pandoc.sh && \
   install2.r rmarkdown
ENV RSTUDIO_PANDOC=/usr/lib/rstudio/bin/pandoc
COPY . /home/user
WORKDIR /home/user/
RUN Rscript -e "rmarkdown::render('Paper.Rmd')"

错误原因 #

rocker/r-ver:4.2.2是仅包含基础R运行环境的轻量镜像，未预装LaTeX编译工具链。而rmarkdown::render()生成PDF时，需要先将RMarkdown转为.tex文件，再通过pdflatex等LaTeX引擎编译为PDF，缺失pdflatex会导致编译失败。

解决方案 #

方案1：使用预装LaTeX的Rocker镜像（推荐） #

Rocker官方提供了rocker/verse镜像，该镜像已预装完整的LaTeX环境、pandoc和常用R包，无需手动安装依赖。修改Dockerfile如下：

FROM rocker/verse:4.2.2
COPY . /home/user
WORKDIR /home/user/
RUN Rscript -e "rmarkdown::render('Paper.Rmd')"

方案2：在原镜像中手动安装LaTeX组件 #

若需保留rocker/r-ver基础镜像，可在Dockerfile中添加texlive相关包的安装步骤，补充pdflatex及核心LaTeX组件：

FROM rocker/r-ver:4.2.2
RUN apt-get update \
  && apt-get install -y --no-install-recommends \
   wget \
   graphviz \
   perl \
   texlive-base \
   texlive-latex-recommended \
   texlive-fonts-recommended && \
   /rocker_scripts/install_pandoc.sh && \
   install2.r rmarkdown
ENV RSTUDIO_PANDOC=/usr/lib/rstudio/bin/pandoc
COPY . /home/user
WORKDIR /home/user/
RUN Rscript -e "rmarkdown::render('Paper.Rmd')"

验证步骤 #

修改Dockerfile后，重新执行构建命令：

docker build . -t analysis

构建成功后，容器内的/home/user/目录下会生成Paper.pdf文件。若需将PDF导出到本地，可在构建完成后运行容器并挂载本地目录，或在Dockerfile末尾添加复制指令。

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