You need to enable JavaScript to run this app. TypeORM连接本地SQL Server出现1433端口ESOCKET连接失败问题求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 10:36:05