MS SQL连接isql可用但node-odbc连接失败问题排查

故障出在JavaScript字符串的转义规则上：

• 你在shell中执行isql时，双引号包裹的连接字符串里的反斜杠\会被完整传递给ODBC驱动，因此命名实例myServerName\myInstanceName能被正确解析，连接正常。
• 在Node.js代码中，单/双引号包裹的普通字符串里，反斜杠是转义标识符，你写的\myInstanceName中，反斜杠会被JS解析器吞掉（\m属于无效转义序列，JS会直接丢弃反斜杠保留m），最终传给ODBC驱动的SERVER值变成了myServerNamemyInstanceName，驱动找不到对应服务器，自然触发超时、实例不存在的报错。

将连接字符串里命名实例前的反斜杠转义为双反斜杠，保证最终传给驱动的字符串里保留单斜杠即可：

const odbc = require('odbc');
// 注意SERVER字段里的\\，转义后实际传递给驱动的是\
const connection = await odbc.connect('DRIVER={ODBC Driver 18 for SQL Server};SERVER=myServerName\\myInstanceName;DATABASE=myDatabase;UID=username;PWD=password;TrustServerCertificate=YES;');

如果修改后仍连接失败，按以下步骤校验：

• 第一步先打印传给odbc.connect的完整字符串，确认输出内容中SERVER部分为myServerName\myInstanceName，没有丢反斜杠
• 确认运行Node进程的用户和你测试isql的用户一致，避免因用户级ODBC配置隔离导致驱动加载异常
• 若你的SQL Server命名实例依赖Browser服务解析端口，确认容器到数据库主机的UDP 1434端口连通性正常，命名实例需要通过该端口获取实际监听的TCP端口

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