news 2026/4/15 18:50:50

Caused by:com.microsoft.sqlserver.jdbc.SQLServerException: 通过端口 1433 > 连接到主机 localhost 的 TCP/IP 连接失败

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Caused by:com.microsoft.sqlserver.jdbc.SQLServerException: 通过端口 1433 > 连接到主机 localhost 的 TCP/IP 连接失败


在使用SQLServer数据库运行项目程序的时候,报错

Caused by: com.microsoft.sqlserver.jdbc.SQLServerException: 通过端口 1433
连接到主机 localhost 的 TCP/IP 连接失败。错误:“Connection refused:
connect。请验证连接属性。确保 SQL Server 的实例正在主机上运行,且在此端口接受 TCP/IP 连接,还要确保防火墙没有阻止到此端口的 TCP 连接。”。com.microsoft.sqlserver.jdbc.SQLServerException.makeFromDriverError(SQLServerException.java:190)

根据以往使用数据库的经验,首先排查防火墙中是否拦截了1433端口,但是1433端口已经打开,并且在防火墙关闭的情况下,仍然存在上述报错,后面通过下面方式解决

一:首先检查一下下面的三个内容

1.确认 SQL Server 实例是否真的在监听 1433 端口

以管理员身份打开命令行窗口,执行下面的命令

# 查看所有监听的 TCP 端口netstat-ano|findstr"LISTENING"|findstr"1433"

正常的执行情况为

执行之后,窗口显示下面内容,说明没有在监听

直接重新配置TCP/IP 协议

2.确认 SQL Server 服务是否为「默认实例」

打开服务(Win+R → services.msc):
若服务名是SQL Server (MSSQLSERVER)→ 是默认实例,应监听 1433 端口;

若服务名是SQL Server (SQLEXPRESS)/SQL Server (自定义实例名)→ 是命名实例,默认不监听 1433 端口

直接改连接字符串为

// 命名实例写法(无需端口) jdbc:sqlserver://localhost\SQLEXPRESS;databaseName=你的库名;encrypt=false;trustServerCertificate=true

3.临时关闭防火墙验证(排除拦截)

打开「Windows Defender 防火墙」→ 「启用或关闭 Windows Defender 防火墙」→ 临时关闭「专用网络」「公用网络」的防火墙;

重新运行程序,若能连接 → 说明是防火墙拦截,需按之前步骤放行 1433 端口(或命名实例的动态端口);
若仍不能连接 → 排除防火墙问题,聚焦 SQL Server 配置。

二:针对「默认实例 1433 端口未监听」的修复步骤

1. 重启 SQL Server 服务(先简单试)

右键「SQL Server (MSSQLSERVER)」→ 「停止」→ 等待 10 秒 → 「启动」;
重启后再次执行下面的命令,看是否监听。

netstat-ano|findstr1433

2. 重新配置 TCP/IP 协议(关键)

打开SQL Server 配置管理器(Win+R → SQLServerManager15.msc,版本对应:2019=15、2017=14)或者直接搜索SQL Server 配置管理器即可;

展开SQL Server 网络配置→ 点击MSSQLSERVER 的协议

右键TCP/IP启用(灰色则已启用);

双击TCP/IP→ 切换到IP 地址标签页:

找到IP1 IP2… IPAll,依次检查:

所有已启用列设为

IPAll下:TCP 端口填 1433,TCP 动态端口清空;

点击确定→ 会提示需重启服务生效,再次重启SQL Server (MSSQLSERVER)

重启后执行netstat -ano | findstr 1433,确认有LISTENING状态。

三: JFinal 框架专属配置检查

1. 连接字符串必须加 2 个参数(高版本 SQL Server 必加)

java运行

// 正确的连接字符串模板(默认实例)StringjdbcUrl="jdbc:sqlserver://localhost:1433;databaseName=你的库名;encrypt=false;trustServerCertificate=true";// 命名实例模板StringjdbcUrl="jdbc:sqlserver://localhost\SQLEXPRESS;databaseName=你的库名;encrypt=false;trustServerCertificate=true";encrypt=false:关闭 SSL 加密(本地测试用,生产可按需开启); trustServerCertificate=true:跳过证书验证(避免「SSL 握手失败」)

2. 确认 JFinal 数据源配置未写错

java运行

// 初始化 Druid 数据源(JFinal 常用)DruidPlugindruidPlugin=newDruidPlugin(jdbcUrl,// 上面的连接字符串"sa",// 数据库账号(确认已启用)"你的密码",// 确认密码正确"com.microsoft.sqlserver.jdbc.SQLServerDriver"// 驱动类不要写错);// 启动数据源 + ActiveRecorddruidPlugin.start();ActiveRecordPluginarp=newActiveRecordPlugin(druidPlugin);arp.start();// 报错发生在这一步,说明数据源连不上

3. 验证账号密码是否正确

打开 SSMS → 用SQL Server 身份验证→ 输入 sa + 密码 → 看能否连接本地实例;
若不能连接:右键sa属性→ 取消登录已禁用→ 重置密码 → 重启 SQL Server 服务。

四、终极兜底方案(以上都无效时)

1. 检查 SQL Server 是否安装损坏

控制面板 → 卸载程序 → 找到Microsoft SQL Server→ 选择修复
修复完成后,重新配置 TCP/IP 协议 + 重启服务。

2. 更换连接地址(localhost → 127.0.0.1)

部分环境下 localhost 解析异常,替换连接字符串为:

java运行

jdbc:sqlserver://127.0.0.1:1433;databaseName=你的库名;encrypt=false;trustServerCertificate=true

3. 查看 SQL Server 错误日志

打开 SSMS → 连接实例(若能连)→ 展开管理SQL Server 日志→ 查看最近的错误,会提示为何 1433 端口未监听(如权限不足、配置错误);
若连不上 SSMS,日志文件默认路径:C:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\MSSQL\Log\ERRORLOG

欢迎大家点赞,评论,加关注呦

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/16 10:08:20

Umi-OCR多引擎适配实战:如何为不同场景选择最优识别方案

Umi-OCR多引擎适配实战:如何为不同场景选择最优识别方案 【免费下载链接】Umi-OCR Umi-OCR: 这是一个免费、开源、可批量处理的离线OCR软件,适用于Windows系统,支持截图OCR、批量OCR、二维码识别等功能。 项目地址: https://gitcode.com/Gi…

作者头像 李华
网站建设 2026/4/15 17:25:30

虚拟手柄驱动终极配置完整指南

虚拟手柄驱动终极配置完整指南 【免费下载链接】ViGEmBus 项目地址: https://gitcode.com/gh_mirrors/vig/ViGEmBus 虚拟手柄驱动技术为Windows游戏控制带来革命性突破,通过游戏控制器模拟实现专业级多设备并行运行体验。本指南将详细解析从基础安装到高级故…

作者头像 李华
网站建设 2026/4/16 10:55:17

Linux进程基础

一、进程与程序:静态与动态的本质区别初学者易混淆进程与程序,二者从存在形式、生命周期、资源占用等维度存在本质差异,核心是 “静态文件” 与 “动态执行实例” 的区别:维度程序(Program)进程&#xff08…

作者头像 李华
网站建设 2026/4/16 13:53:52

TranslucentTB中文设置终极指南:轻松实现任务栏透明化

TranslucentTB中文设置终极指南:轻松实现任务栏透明化 【免费下载链接】TranslucentTB 项目地址: https://gitcode.com/gh_mirrors/tra/TranslucentTB TranslucentTB是一款功能强大的Windows任务栏透明化工具,能够让你的桌面界面焕然一新。很多用…

作者头像 李华
网站建设 2026/4/16 10:55:59

暗黑破坏神3智能自动化辅助工具实战指南

D3keyHelper作为一款专为《暗黑破坏神3》设计的图形化自动化工具,通过智能连招系统和多配置管理功能,为玩家提供全方位的游戏辅助体验。无论你是追求效率的资深玩家,还是刚入门的新手,这款工具都能显著提升你的游戏表现。 【免费下…

作者头像 李华
网站建设 2026/4/12 20:10:04

终极桌面整理神器:NoFences让Windows工作区焕然一新

终极桌面整理神器:NoFences让Windows工作区焕然一新 【免费下载链接】NoFences 🚧 Open Source Stardock Fences alternative 项目地址: https://gitcode.com/gh_mirrors/no/NoFences 在数字时代,桌面已经成为我们工作和生活的中心舞台…

作者头像 李华