Windows Server下PM2托管的R Plumber调用包内函数偶发500错误排查求助

排查方向 #

• 首先补全全链路错误日志：Windows环境下PM2默认可能无法完整捕获R进程的stderr输出，你需要在Plumber入口文件头部添加代码主动落盘错误栈：

# 全局错误捕获，将错误栈写入本地日志
options(error = function() {
  log_con <- file("plumber_error_stack.log", open = "a")
  sink(log_con, type = "output")
  cat("错误发生时间：", Sys.time(), "\n")
  print(sys.calls())
  print(traceback())
  sink(type = "output")
  close(log_con)
})

同时给所有调用第三方包的端点加tryCatch包裹，额外输出调用时的包加载路径、运行时环境变量，确认故障发生时的上下文是否存在异常。

• 排查第三方包的会话状态污染问题：多数涉及C/C++扩展、临时文件读写、网络长连接的R第三方包，都会在R会话内存中留存全局状态，Plumber默认复用单会话处理请求时，如果某一次请求异常中断，很容易导致全局状态被破坏，后续同包的函数调用会直接崩溃，而新开RGui是独立会话，因此调用正常。

验证方法：修改Plumber启动参数，关闭会话复用，设置pr_run(workers = 1, preemptive = FALSE)，如果故障不再出现，即可确认是包的全局状态污染导致。

• 核对PM2运行环境与本地RGui的差异：如果PM2是注册为Windows系统服务运行，默认使用Local System账户，和你登录RGui使用的用户账户在环境变量、文件权限、网络权限上存在差异：比如第三方包依赖的用户目录配置、映射网络盘权限、PATH变量，都可能随机出现访问失败的情况。

验证方法：进入Windows服务管理界面，找到PM2对应的服务，将运行账户修改为你日常登录的管理员账户，重启服务后观察故障频率是否下降。

• 排查内存泄漏问题：R的内存回收是会话级的，Plumber进程长期运行如果存在内存泄漏，达到系统内存阈值后，第三方包的扩展程序申请内存失败会直接终止，不会返回R层错误信息，因此无报错日志。你可以通过PM2的pm2 monit命令长期观察Plumber进程的内存占用变化，确认是否存在持续上涨的情况。

解决方案 #

• 确认是会话状态污染导致的话，可以将Plumber调整为多进程模式，或者配置PM2的max_memory_restart参数，达到内存阈值后自动重启进程，示例PM2配置：

{
  "name": "plumber-service",
  "script": "plumber.R",
  "interpreter": "Rscript.exe",
  "max_memory_restart": "2G",
  "env": {
    "PATH": "你的R运行环境PATH完整路径"
  }
}

• 临时兜底方案：如果暂时无法定位根因，可以配置PM2定时重启策略，比如每天业务低峰期自动重启一次Plumber进程，可规避90%以上的偶发会话状态类故障。

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