R中write_xlsx导出大型data.frame出现libxlsxwriter ZIP_ERRNO及文件锁问题求助

故障根因匹配 #

• 这类报错和R代码逻辑无关，核心诱因是目标文件路径存在系统级残留文件锁，和之前未等写入完成就提前打开导出文件的误操作直接相关
• writexl底层依赖的libxlsxwriter在打包xlsx（本质是zip压缩包）时，没有单独捕获文件被占用的系统错误，只会笼统抛出ZIP_ERRNO通用报错，甚至会显示“System error = No error”的误导性提示
• 小文件可写入、大文件报错的差异来源：1.5MB规模的文件写入耗时极短，哪怕存在文件锁，往往能趁系统权限校验的间隙完成写入，但会留下R进程未正常释放的文件句柄——也就是之前遇到的，打开生成的小文件时提示被R锁定、仅能只读打开的问题；150MB规模的文件写入耗时更长，会直接触发文件写权限校验失败，中断zip打包流程

落地解决步骤 #

• 清理目标路径的残留锁
  • 导航到之前设置的导出路径，删除两类残留文件：一是所有以~$开头的Excel隐藏临时文件，二是历次未写完的同路径xlsx残留文件
  • 如果是Windows系统，重启资源管理器进程即可清除大部分无主的孤儿文件锁；如果是Mac/Linux系统，通过文件路径查询占用进程，直接结束对应进程即可，仅重启R无法清除系统层面的锁
• 规避路径本身的锁风险
  • 不要把导出路径设置在云同步盘的文件夹下，云同步进程会实时扫描、临时锁定目录内的文件，写入过程极易出现权限冲突
  • 提前验证路径写权限：在目标路径下执行writeLines("test", con = "test_perm.txt")，确认能正常写入、删除测试文件后，再运行导出代码
• 绕开writexl的大文件写入缺陷
  • 不复用之前出过错的文件路径，每次导出使用全新命名的目标文件，减少系统权限缓存带来的锁残留
  • 采用两段式导出：先将数据写入R的临时目录（无外部进程干扰），导出完成后再通过file.copy()将临时文件移动到最终存储路径，可大幅降低写入过程被锁的概率
  • 导出150MB规模数据时，在write_xlsx()中添加format_headers = FALSE参数，减少样式计算的性能开销，缩短写入时长
• 解决导出后文件被R锁定的问题
  • 调用完write_xlsx()后立即执行gc()强制回收R内存，释放未关闭的文件句柄，即可消除打开生成文件时的只读锁定提示

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