使用officedown渲染RMarkdown时随机出现zip::unzip错误求助

用户配置与错误信息 #

YAML配置 #

---
date: "`r str_to_title(format(Sys.time(), '%B, %Y'))`"
#author: "Florestal Package"
title: "Relatório Técnico de Inventário Florestal"
output: 
  officedown::rdocx_document:
    reference_docx: "template.docx"
    tables:
      style: 'Grid Table 1 Light'
      caption:
        style: Table Caption
        pre: 'Tabela '
        sep: '. '
    plots:
      caption:
        style: Image Caption
        pre: 'Figura '
        sep: '. '
    page_margins:
      bottom: 0.78
      top: 1.18
      right: 0.78
      left: 1.18
      header: 0.78
      footer: 0.78
      gutter: 0

---

渲染代码 #

rmarkdown::render('Inventario_Florestal_Relatorio_Tecnico_ACS.Rmd',
                  output_file = paste(getwd(),'/myfile',
                                      '.docx', sep=''),
                  encoding="UTF-8")  

随机错误信息 #

Quitting from lines 49-52 (teste_.Rmd)
Error in zip::unzip(zipfile = file, exdir = folder) : 
  zip error: `Failed to set mtime on `word/theme/theme1.xml` while extracting `C:\Users\igorc\Documents\Backup 2022\Florestal_Rmarkdown\florestal_rmarkdown\template.docx`` in file `zip.c:260`

问题原因分析 #

• 资源竞争与文件锁定：大文件渲染时，officedown会频繁读写临时文件（如解压模板docx），若系统内存/CPU占用过高，或杀毒软件、文件同步工具（如OneDrive）正在访问临时目录或模板文件，会导致zip解压时无法修改文件时间戳（mtime），触发随机错误。小文件渲染速度快，资源占用低，冲突概率极低。

• 临时文件堆积：大文件生成的临时文件更多，若R临时目录（tempdir()）空间不足或旧临时文件未被及时清理，会干扰解压操作。多次尝试时，临时目录可能被自动清理，因此偶尔能成功渲染。

• 模板文件权限或隐性损坏：若模板文件被设置为只读，或系统对其存在隐性锁定，大文件渲染时多次访问模板更容易触发权限错误；此外，模板xml结构的微小隐性损坏，可能在小文件渲染时未触发，却在大文件复杂操作中暴露。

• 内存不足导致异常：大文件渲染需要更多内存，当内存不足时，R进程可能出现异常，导致zip解压中途失败，且错误位置随机（每次内存耗尽的时机不同）。

建议解决措施 #

• 关闭杀毒软件、文件同步工具，避免它们锁定临时文件或模板。
• 手动清理R临时目录：运行unlink(tempdir(), recursive = TRUE)后重启R，再尝试渲染。
• 检查模板文件权限，确保可读写；或复制一份新的模板文件到工作目录替换原文件。
• 增加R可用内存，或拆分大文件为多个小模块，分块渲染后合并文档。
• 更新officedown、zip、rmarkdown等相关包至最新版本，修复已知的文件操作bug。

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