Flexdashboard Storyboard Knit时ODBC环境变量连PostgreSQL失败

问题背景 #

在非本地服务器上使用R 4.1.0 + RStudio 2021.09.2，搭配flexdashboard 0.5.2和ODBC 1.3.3开发Storyboard，通过系统环境变量存储数据库用户名和密码，编写函数完成连接取数。手动运行代码块正常，但执行Knit操作时出现PostgreSQL密码认证失败，硬编码密码则可正常运行。

报错信息示例：

Line XX Error: nanodbc/nanodbc.cpp:1021: 00000: [unixODBC][RStudio][PostgreSQL] (10) Error occurred while trying to connect: [SQLState 28000] FATAL: password authentication failed for user "myuser"
FATAL: password authentication failed for user "myuser"
Execution halted

可行解决方法 #

1. 让Knit进程读取环境变量（推荐） #

Knit会启动独立的R进程，默认不会继承当前RStudio会话的临时环境变量。可以把敏感信息写入R的全局配置文件.Renviron：

• 在RStudio中执行file.edit("~/.Renviron")打开配置文件
• 添加以下内容（替换为你的实际信息）：

  myuser=你的数据库用户名
  mypasswordwithspecialcharacters=你的数据库密码（特殊字符直接写入，无需转义）
  

• 保存文件后重启RStudio，再执行Knit。Knit进程会自动加载.Renviron中的环境变量。

2. 显式设置环境变量（应急方案） #

如果无法修改.Renviron，可以在Rmd的第一个代码块中显式设置环境变量（注意：该方法不适合共享环境，避免密码泄露）：

Sys.setenv(
  myuser = "你的数据库用户名",
  mypasswordwithspecialcharacters = "你的数据库密码"
)

3. 用config包管理数据库配置（更规范的方式） #

使用config包统一管理配置，避免直接暴露环境变量或硬编码：

1. 安装config包：

   install.packages("config")
   

2. 在项目根目录创建config.yml文件：

   default:
     db:
       driver: "PostgreSQL"
       database: "mydb"
       uid: "myuser"
       pwd: "你的数据库密码"
       host: "myhost"
       port: 8888
   

3. 在R代码中读取配置并建立连接：

   library(DBI)
   library(odbc)
   library(config)
   
   get_db_table <- function(){ 
     db_config <- config::get("db")
     print("connecting...")
     con <- dbConnect(odbc::odbc(),
                      Driver = db_config$driver,
                      Database = db_config$database,
                      UID = db_config$uid,
                      PWD = db_config$pwd,
                      host = db_config$host,
                      Port = db_config$port,
                      MultipleActiveResultSets = "True")
     # 取数逻辑...
     print("connected!")
     dbDisconnect(con)
     return("done----")
   }
   
   myT <- get_db_table()
   

4. 将config.yml加入.gitignore，防止密码泄露到版本控制系统。

4. 检查特殊字符的环境变量处理 #

如果密码包含$、!等shell特殊字符，写入.Renviron时用单引号包裹：

mypasswordwithspecialcharacters='pass$word123!'

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