含flextable的R Markdown无法编译PDF的问题求助

问题背景 #

使用R Markdown结合flextable包生成PDF时，pdflatex报错GUI framework cannot be initialized，但单独编译LaTeX文件正常，且可成功导出Word/HTML格式。已尝试降级flextable至0.6.6、更新MiKTeX，问题仍存在。环境版本：flextable 0.9.5、R 4.2.2、MiKTeX 4.19.0。

错误原因 #

该错误本质是MiKTeX在后台（通过R调用）运行时无法初始化GUI组件。通常是因为R生成的LaTeX代码依赖某些未安装的包，而pdflatex在batchmode下无法弹出GUI安装提示，导致进程崩溃。

解决方案 #

1. 配置MiKTeX自动安装缺失包（无GUI模式） #

• 打开MiKTeX Console，进入Packages标签页
• 点击右上角Settings，在General选项中：
  • 将Install missing packages on-the-fly设置为Always
  • 勾选Use package repository确保可联网安装包
• 切换到Advanced标签页，勾选Allow MiKTeX to run in batch mode

2. 手动安装flextable依赖的LaTeX包 #

flextable生成PDF需要以下核心LaTeX包，在MiKTeX Console中搜索并安装：

• booktabs、array、colortbl、xcolor、graphicx、geometry、hyperref

3. 修改R Markdown编译参数 #

在YAML头部添加额外参数，强制pdflatex使用非交互模式并禁用GUI：

---
title: "Untitled"
output:
  pdf_document:
    latex_engine: pdflatex
    extra_args: ["-interaction=nonstopmode", "-no-gui"]
    keep_tex: true # 保留生成的tex文件，方便排查
    extra_dependencies:
      - booktabs
      - array
---

4. 替换为TinyTeX（无GUI TeX发行版） #

若MiKTeX的GUI问题无法解决，可尝试使用TinyTeX：

# 安装tinytex包
install.packages("tinytex")
# 安装TinyTeX发行版
tinytex::install_tinytex()

安装完成后重新编译R Markdown，TinyTeX默认无GUI，可避免此类错误。

5. 检查运行权限 #

确保R/RStudio以管理员权限运行，避免MiKTeX安装包时因权限不足触发GUI错误。

验证步骤 #

1. 按上述配置修改后，重新编译R Markdown
2. 若仍失败，查看生成的.tex文件（因设置了keep_tex: true）
3. 手动用MiKTeX编译该.tex文件，此时会弹出具体的包缺失提示，安装对应包后再次尝试

原始问题代码 #

---
title: "Untitled"
output: pdf_document
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
library(flextable)

ft <- flextable(head(airquality))
ft <- autofit(ft)
theme_vader(ft)

### 原始错误日志
> Sorry, but C:\Users******\MiKTeX\miktex\bin\x64\pdflatex.exe did not succeed.

2024-04-22 14:28:28,136+0200 INFO pdflatex - this process (34480)
started by Rterm in directory
C:\Users*\manuscript with command line:
C:\Users*\AppData\Local\Programs\MiKTeX\miktex\bin\x64\pdflatex.exe
-halt-on-error -interaction=batchmode test.tex 2024-04-22 14:28:28,137+0200 INFO pdflatex - running on Windows 10.0.22631
2024-04-22 14:28:28,140+0200 INFO pdflatex - this is MiKTeX-PDFTEX
4.19.0 (1.40.26) (MiKTeX 24.3.31) 2024-04-22 14:28:28,144+0200 INFO pdflatex - allowing known shell commands 2024-04-22 14:28:28,438+0200
FATAL pdflatex.core - GUI framework cannot be initialized. 2024-04-22
14:28:28,438+0200 FATAL pdflatex.core - Data: 2024-04-22
14:28:28,438+0200 FATAL pdflatex.core - Source:
Libraries\MiKTeX\UI\Qt\mikuiqt.cpp:126 2024-04-22 14:28:28,438+0200
FATAL pdflatex - GUI framework cannot be initialized. 2024-04-22
14:28:28,438+0200 FATAL pdflatex - Info: 2024-04-22 14:28:28,438+0200
FATAL pdflatex - Source: Libraries\MiKTeX\UI\Qt\mikuiqt.cpp 2024-04-22
14:28:28,438+0200 FATAL pdflatex - Line: 126 2024-04-22
14:28:28,440+0200 INFO pdflatex - this process (34480) finishes with
exit code 1

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