Shiny App部署至shinyapps.io连接MySQL报错：本地运行正常

我之前碰到好几个朋友遇到过类似的情况——本地跑的好好的Shiny App，一部署到shinyapps.io就连不上远程MySQL，哪怕已经加了IP白名单。咱们一步步来排查和解决：

一、先把连接配置的坑踩平 #

• 千万不要硬编码密码、用户名这类敏感信息！shinyapps.io上一定要用环境变量来存这些内容：你可以登录shinyapps.io，找到你的应用→Settings→Environment，把DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORD这些变量加进去。本地测试的时候，在项目根目录建个.Renviron文件，把这些变量写进去（格式是DB_PASSWORD=your_pass），这样本地和部署环境的代码完全一致，不会因为硬编码的差异掉链子。
• 逐字核对连接参数：host是不是远程MySQL的公网IP/域名？port是不是默认的3306（如果改了端口一定要对应）？dbname有没有拼错？别小看这种低级错误，很多时候问题就出在这儿。
• 检查MySQL用户的远程连接权限：你的数据库用户是不是只能本地登录？比如如果用户是your_user@localhost，那从shinyapps.io肯定连不上。得改成允许远程连接的用户：

  CREATE USER 'your_user'@'%' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON your_database.* TO 'your_user'@'%';
  FLUSH PRIVILEGES;
  

  这里的%表示允许任何IP连接，如果你想更安全，也可以换成shinyapps.io的IP范围。

二、确认Pool的初始化位置是否正确 #

连接池的代码绝对不能乱摆：

• 必须放在global.R里！这样整个应用启动时只会初始化一次连接池，避免重复创建连接导致的资源耗尽或失败。如果放在server.R里，每个用户发起请求都可能创建新连接，很容易出问题；放ui.R里就更离谱了，ui是在客户端运行的，根本没法连数据库。
• 给你个正确的初始化示例：

  # global.R
  library(pool)
  library(RMariaDB) # 如果你用的是RMySQL就换RMySQL
  
  # 用环境变量调用配置
  pool <- dbPool(
    drv = RMariaDB::MariaDB(),
    host = Sys.getenv("DB_HOST"),
    port = as.integer(Sys.getenv("DB_PORT")),
    dbname = Sys.getenv("DB_NAME"),
    user = Sys.getenv("DB_USER"),
    password = Sys.getenv("DB_PASSWORD"),
    minSize = 2, # 最小连接数
    maxSize = 10, # 最大连接数
    idleTimeout = 3600 # 空闲连接超时时间
  )
  
  # 应用停止时关闭连接池，避免资源泄漏
  onStop(function() {
    poolClose(pool)
  })
  

三、核对驱动版本和依赖 #

• 本地和shinyapps.io上的数据库驱动版本要统一！比如你本地用的是RMariaDB 1.2.0，而shinyapps.io默认装的是旧版本，很可能出现兼容性问题。你可以在本地跑sessionInfo()查看版本，然后在项目的DESCRIPTION文件里指定版本，比如加一行：Imports: RMariaDB (>= 1.2.0)，这样shinyapps.io会自动安装指定版本的包。
• 确保所有依赖包都在代码里明确加载了，比如在global.R里加载pool和数据库驱动，不要依赖本地全局安装的包——shinyapps.io只会安装你代码里用到的包。

四、再确认白名单和网络连通性 #

• 别只加单个shinyapps.io的IP！shinyapps.io有一整套IP范围，你得把所有相关IP段都加到MySQL服务器的白名单里。可以去shinyapps.io官方文档找到完整的IP列表，一次性加全。
• 测试端口是否开放：用telnet或者在线端口检测工具，验证从shinyapps.io的IP能不能访问MySQL的3306端口（如果改了端口就对应你的端口）。如果端口不通，哪怕IP白名单了也没用，得检查MySQL服务器的防火墙设置。

五、看日志！看日志！看日志！ #

这是最关键的一步！去shinyapps.io的应用页面，找到“Logs”选项卡，看详细的错误日志——日志会直接告诉你问题出在哪儿：

• 如果日志显示Access denied for user 'xxx'@'yyy'：要么是用户权限没开，要么是白名单没加对这个IP；
• 如果显示Could not resolve host：那是host参数写错了；
• 如果显示Timeout connecting to server：可能是网络延迟或者超时时间设置太短，可以在dbPool里加timeout = 10（单位秒）试试。

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