如何修复RStudio连接SQL Server时nanodbc.cpp:1021登录超时过期错误

首先先明确你遇到的报错内容：

Error: nanodbc/nanodbc.cpp:1021: HYT00: [Microsoft][ODBC SQL Server Driver]Login timeout expired

你可以按照以下优先级逐一排查问题：

1. 网络连通性排查 #

• 在本机命令行执行ping <SQL Server所在服务器IP>，确认服务器网络可达，没有丢包、阻断的情况
• 执行telnet <SQL Server所在服务器IP> <端口号>（SQL Server默认端口为1433），确认端口未被本地防火墙、服务器防火墙拦截，SQL Server服务已经在对应端口正常监听
• 如果是云服务器部署的SQL Server，需要检查对应实例的安全组、访问控制规则是否放开了你本机IP的端口访问权限

2. ODBC驱动与连接配置排查 #

• 确认本机安装的ODBC Driver for SQL Server版本和你代码中指定的驱动版本完全一致，可在Windows的ODBC数据源管理器、或Linux/macOS下执行odbcinst -q -d命令查看已安装驱动的准确名称，避免名称拼写错误
• 核对所有连接参数：服务器地址、实例名、端口号、身份验证模式（SQL Server身份验证/Windows集成身份验证）、用户名密码是否和目标实例要求完全匹配
• 如果使用Windows集成身份验证，可先在ODBC数据源管理器中手动创建测试连接，确认系统层面的身份验证可以正常通过

3. 连接参数调优 #

你可以在dbConnect()函数中增加timeout参数，适当延长超时阈值，参考代码如下：

conn <- DBI::dbConnect(odbc::odbc(),
                      Driver = "ODBC Driver 17 for SQL Server",
                      Server = "你的服务器地址,端口号",
                      Database = "目标数据库名",
                      UID = "登录用户名",
                      PWD = "登录密码",
                      timeout = 30) # 单位为秒，可根据实际网络情况继续上调

4. SQL Server实例侧排查 #

• 确认目标SQL Server实例已经开启远程连接权限，可在SQL Server配置管理器中查看对应配置项
• 如果你使用的是SQL Server命名实例而非默认实例，需要确认目标服务器上的SQL Server Browser服务已经正常启动
• 确认实例侧没有针对你的账号/IP的访问限制，登录账号没有被锁定，也没有出现并发连接数超限的情况

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