.NET 4.7.2迁移到.NET Core 3.1后IBM Db2连接失败如何解决

• IBM.Data.DB2.Core 驱动与 .NET Framework 版的 DB2 驱动对连接字符串的解析逻辑、客户端配置依赖存在明显差异：.NET Framework 版驱动可默认读取本地 DB2 客户端编目（catalog）中配置的数据库别名对应的服务端地址、端口等信息，但 .NET Core 版驱动默认不会主动读取本地客户端编目配置，仅靠 Database 参数无法定位目标数据库
• 连接字符串缺少 .NET Core 版驱动必需的服务端地址、端口参数，驱动读取到的数据库配置不完整，因此抛出数据库名为空的 SQL1013N 报错
• 存在小概率是 DB2 客户端版本与 Nuget 驱动版本不匹配，导致配置读取失败

1. 验证配置读取正确性 #

首先确认你从配置中心拿到的连接字符串完整无误，可在创建连接前打印或断点查看 GetConnectionString("IDAA") 的返回值：

// 临时添加调试代码
var connStr = GetConnectionString("IDAA");
Debug.WriteLine(connStr);
// 确认返回值不是空值、不存在配置键写错导致的内容缺失
using (var con = new DB2Connection(connStr))

同时检查 appsettings.json 的结构是否与配置读取路径匹配：

{
  "appSettings": {
    "ConnectionStrings": {
      "FoFDb2ContextIDAA": "你的完整连接字符串"
    }
  }
}

2. 补全连接字符串必填参数 #

.NET Core 版 DB2 连接字符串必须显式指定服务端地址、端口，修改后的格式参考如下：
Server=DB2服务端IP:端口号;Database=hereCorrectName;UID=user;PWD=@pwd@;

• DB2 默认非SSL端口为 50000，SSL端口为 50001
• 如果使用SSL连接，额外添加 Security=SSL; 参数即可

3. 校验驱动与客户端版本匹配 #

• 确认项目中安装的 IBM.Data.DB2.Core Nuget 包大版本与本地安装的 DB2 Runtime Client V11.1.4 一致，版本差不能超过1个小版本
• 版本不匹配时优先将 Nuget 包降级到 11.1.4 对应的版本，兼容性更好

4. 强制指定客户端路径（可选） #

如果上述步骤都完成还是报错，可在程序启动入口处添加代码指定 DB2 客户端安装路径，避免驱动找不到本地配置：

// 替换为你本地DB2客户端的实际安装路径，默认是C:\Program Files\IBM\SQLLIB
IBM.Data.DB2.Core.DB2Configuration.SetClientInstallPath("C:\\Program Files\\IBM\\SQLLIB");

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