无法从R部署Shiny应用：Terra包编译失败

Terra包编译失败通常是因为部署环境（多为Linux系统）缺少它依赖的底层地理空间系统库，或是强制源码编译而非使用预编译二进制包导致的，以下是具体解决办法：

• 安装系统级依赖库
  Terra依赖GDAL、GEOS、PROJ三个核心地理空间库，部署服务器必须先安装这些库：

  • 针对Debian/Ubuntu系统，执行：

    sudo apt-get update && sudo apt-get install libgdal-dev libgeos-dev libproj-dev
    

  • 针对RHEL/CentOS系统，执行：

    sudo yum install gdal-devel geos-devel proj-devel
    

• 优先使用二进制包安装Terra
  源码编译易出问题，强制安装预编译二进制包可跳过编译步骤。在Shiny应用启动脚本开头添加：

  options(repos = c(CRAN = "https://cloud.r-project.org"))
  install.packages("terra", type = "binary")
  

  若用renv管理依赖，可在renv/settings.dcf中设置install.type = binary，确保所有包都以二进制形式安装。

• 对齐部署环境与本地的R版本
  确认部署服务器的R版本和你本地的4.3.2完全一致，版本不匹配可能引发编译兼容性问题。若部署环境R版本较低，升级至4.3.2即可。

• 排查不必要的依赖链
  在本地用以下命令查看Leaflet的依赖链，确认Terra是被哪个包间接引入的：

  tools::package_dependencies("leaflet", recursive = TRUE)
  

  如果是某个非核心依赖引入了Terra，可考虑替换成功能相似但不依赖Terra的包，减少不必要的编译麻烦。

• 用Docker容器部署（推荐）
  容器可彻底消除环境差异，基于官方Shiny镜像构建包含所有依赖的镜像：

  FROM rocker/shiny:4.3.2
  # 安装系统依赖
  RUN apt-get update && apt-get install -y libgdal-dev libgeos-dev libproj-dev
  # 安装所需R包
  RUN R -e "install.packages(c('shiny', 'leaflet', 'sf', 'terra', 'rintrojs', 'tidyr', 'dplyr', 'ggplot2', 'shinythemes'))"
  # 复制应用代码到容器内
  COPY ./your-app-folder /srv/shiny-server/your-app-folder
  

  构建镜像后直接部署，就能和本地环境保持一致。

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