VS2019 SSIS使用Microsoft连接器连接Oracle数据库失败求助

问题现象 #

Visual Studio 2019专业版环境下，在SSIS中使用Microsoft连接器配置Oracle DB Source连接时无法正常建立连接，弹出错误如下：

TITLE: Microsoft Visual Studio
------------------------------

There was an error trying to establish an Oracle connection with the database server.

当前环境信息 #

SQL Server相关组件版本 #

SQL Server Management Studio 15.0.18410.0
SQL Server Management Objects (SMO) 16.100.47008.0
Microsoft Analysis Services Client Tools 15.0.19750.0
Microsoft Data Access Components (MDAC) 10.0.17763.1
Microsoft MSXML 3.0 6.0
Microsoft .NET Framework 4.0.30319.42000
Operating System 10.0.17763
Oracle Client version installed 12

Visual Studio相关版本 #

Microsoft Visual Studio Professional 2019 (2)
Version 16.11.15

Microsoft SQL Server Integration Services Designer
Version 15.0.2000.123

已安装连接器状态 #

Attunity connector v5 已安装，但未在SSIS工具箱显示
Microsoft Connector for Oracle v1 已安装，可在工具箱显示

排查解决步骤 #

• 优先校验驱动位数匹配：Visual Studio 2019是32位进程，SSIS设计阶段默认加载32位驱动。如果当前安装的Oracle 12c客户端仅为64位版本，设计时连接必然失败。需额外安装32位版本Oracle 12c客户端，安装时选择Runtime或Administrator安装类型，不要使用Instant Client轻量版，安装完成后重启Visual Studio再测试连接。
• 修复连接器版本适配问题：当前使用的SSIS Designer 15.0.x对应SQL Server 2019版本的SSIS runtime，Microsoft Connector for Oracle v1存在已知兼容bug。先关闭所有Visual Studio窗口，在控制面板程序列表中卸载现有v1版本连接器，安装适配SQL Server 2019的Microsoft Connector for Oracle正式稳定版，安装完成后重新打开SSIS项目验证组件状态。
• 清理冲突连接器：Attunity connector v5是适配旧版SSIS的连接器，和微软官方Oracle连接器存在程序集加载冲突，直接卸载已安装的Attunity connector v5，避免多版本连接器抢注导致连接异常。
• 先验证基础连通性：配置好Oracle客户端后，先不进入VS，通过Oracle Net Configuration Assistant配置本地网络服务名，使用sqlplus命令行工具测试目标Oracle数据库的连接状态，确认tnsnames.ora配置、账号密码、网络端口、防火墙规则均无异常，排除数据库侧、网络侧故障后再回到VS测试连接器。
• 调整SSIS项目调试配置：右键SSIS项目打开属性页，在调试选项中将Run64BitRuntime参数设置为False，适配设计阶段的32位运行环境，待开发完成部署到服务器时，再根据服务器端安装的64位Oracle客户端情况调整该参数。
• 精准定位未知错误：如果以上操作后仍无法连接，关闭所有Visual Studio窗口，在系统运行窗口执行devenv /log命令启动VS，复现连接报错后，打开路径%APPDATA%\Microsoft\VisualStudio\16.0_<实例随机后缀>\ActivityLog.xml，查找Oracle连接相关的错误条目，确认是否为缺少依赖dll、权限不足、程序集版本不匹配导致的加载失败。

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