TypeORM连接本地SQL Server出现1433端口ESOCKET连接失败问题求助
针对当前TypeORM连接SQL Server ESOCKET报错的可落地排查方案
配置文件显性错误排查
- 空凭证配置无效:当前
ormconfig.ts中username、password字段留空,本地SQL Server默认禁止无凭证匿名接入,首先需要补全实际使用的SQL Server登录账号与密码。如果是Windows集成认证场景,不能直接留空凭证,需要在配置项中追加对应认证规则:
同时必须在连接选项中关闭新驱动默认的强加密校验,否则会在握手阶段直接被断开:"authentication": { "type": "ntlm" }"options": { "encrypt": false, "trustServerCertificate": true, "enableArithAbort": true } - 端口不匹配问题:报错日志显示驱动固定尝试连接1433端口,但本地安装的SQL Server Express/Developer版本默认不会启用固定1433静态端口,使用的是随机动态端口,导致连接被直接拒绝。调整步骤:
- 打开SQL Server配置管理器,找到对应运行实例的TCP/IP协议项,将协议状态改为「已启用」
- 进入TCP/IP属性页,将「TCP动态端口」栏的默认值清空,手动指定静态端口值为1433
- 重启对应SQL Server服务,让端口配置生效
- 命名实例未匹配问题:如果本地安装的是带默认后缀的命名实例(如
SQLEXPRESS),仅配置host: "localhost"会让驱动直接尝试连接未命名实例的1433端口,根本找不到实际运行的服务。这种情况需要将host值修改为"localhost\\SQLEXPRESS",同时在配置中显式指定port值,不要让驱动自行猜测默认端口。
环境层连通性排查
- 本地端口监听校验:打开命令提示符执行
netstat -ano | findstr :1433,如果没有任何返回结果,说明SQL Server根本没有开启TCP监听,回到上一步的配置管理器调整端口设置。 - Windows防火墙拦截校验:系统默认防火墙规则会拦截Node.js进程发起的1433端口连接请求,临时测试可以暂时关闭防火墙,如果关闭后连接成功,就需要新增入站规则,放行
sqlservr.exe和node进程的本地1433端口访问权限。 - 依赖版本兼容问题:当前项目依赖中
mssql@4.3.9搭配typeorm@0.2.29,底层依赖的tedious驱动版本过老,对SQL Server 2019及以上版本的默认加密策略不兼容,即使端口、账号全部配置正确,也会因为加密握手失败触发ESOCKET错误,必须在连接选项中显式关闭强制加密校验。
连通性验证步骤
- 先用SSMS复刻和TypeORM完全一致的连接参数(主机、端口、认证方式、账号密码)尝试连接,确认SSMS能正常连通后,再对比Node驱动的配置差异。很多场景下SSMS能连通是因为使用了Windows集成认证,而Node驱动默认走SQL账号认证,两者认证体系不打通,自然会出现连接失败。
- 如果SSMS连接界面显示的服务器地址格式为
localhost\实例名,端口号,直接把这串内容拆分后原样填入TypeORM的host、port配置项,不要手动拼接时遗漏实例名或端口号。
内容的提问来源于stack exchange,提问作者Nick
相关产品推荐
相关产品推荐

