如何通过 JDBC 在 Java 中正确连接 SQL Server

本文详解 java 项目通过 microsoft jdbc driver 连接本地 sql server 的完整流程，涵盖连接字符串构造、实例名验证、sql server browser 服务配置、防火墙设置及常见超时错误的排查方法。

要成功通过 JDBC 从 Java 应用连接到本地 SQL Server，仅编写 DriverManager.getConnection() 是不够的——必须确保网络可达性、服务可用性、认证合法性与连接参数准确性四者同时满足。您遇到的 SocketTimeoutException: Receive timed out 错误，本质是 JDBC 驱动无法通过 UDP 端口 1434（SQL Server Browser 服务端口）解析命名实例（如 MSSQLSERVER），进而无法定位其实际监听的 TCP 端口（默认 1433 或动态端口）。以下是系统性解决方案：

✅ 第一步：确认 SQL Server 实例类型与端口

• 默认实例（Default Instance）：如安装时未指定实例名，则为 MSSQLSERVER（但连接时无需显式写实例名），直接使用 localhost 或 127.0.0.1 即可，且默认监听 TCP 1433。
• 命名实例（Named Instance）：如自定义实例名为 SQLEXPRESS，则需确保 SQL Server Browser 服务运行，并在连接字符串中包含实例名。

? 快速验证方式（Windows）：

1. 打开 SQL Server Configuration Manager → 展开 SQL Server Network Configuration → 点击对应实例（如 Protocols for MSSQLSERVER）→ 双击 TCP/IP → 切换到 IP Addresses 选项卡 → 滚动到底部查看 TCP Port（若为 0，表示启用动态端口；若为 1433，即固定端口）。
2. 若使用默认实例且 TCP 1433 已启用，推荐绕过实例名解析，直连 IP+端口，避免依赖 SQL Server Browser：

// ✅ 推荐：显式指定端口（跳过 Browser 服务依赖）
String url = "jdbc:sqlserver://localhost:1433;databaseName=datatreck;encrypt=false;trustServerCertificate=true;";
// 注意：SQL Server 2017+ 默认要求加密连接，开发环境可临时加 encrypt=false & trustServerCertificate=true

✅ 第二步：启用并验证关键 Windows 服务

• SQL Server (MSSQLSERVER)：必须处于“正在运行”状态（对应默认实例）。
• SQL Server Browser：仅当使用命名实例（如 \\SQLEXPRESS）时必需；若连接默认实例，该服务可关闭，但您的连接字符串含 \\MSSQLSERVER，JDBC 仍会尝试通过 Browser 解析——这正是超时根源！
  ✅ 解决方案：删除实例名，改用 localhost:1433（见上例）。

✅ 第三步：检查防火墙与网络策略

• 允许入站规则：TCP 端口 1433（非 UDP 1434！Browser 服务仅用于实例发现，生产环境应禁用以提升安全）。
• 若仍需使用命名实例，请额外放行 UDP 端口 1434，并确保 SQL Server Browser 服务启动。

✅ 第四步：完善 JDBC 连接参数（关键！）

Microsoft JDBC Driver 10.2+ 强制要求 TLS 加密。本地开发时，添加以下参数避免 SSL handshake failed：

String url = "jdbc:sqlserv
er://localhost:1433;"
           + "databaseName=datatreck;"
           + "user=sa;"
           + "password=hello;"
           + "encrypt=false;"                    // 禁用加密（仅限开发）
           + "trustServerCertificate=true;";    // 跳过证书验证

⚠️ 注意：encrypt=false 和 trustServerCertificate=true 绝对不可用于生产环境，正式部署必须配置有效证书并启用 encrypt=true。

✅ 最终可运行示例（经验证）

import java.sql.*;

public class JvaConnect2SQL {
    public static void main(String[] args) {
        String url = "jdbc:sqlserver://localhost:1433;databaseName=datatreck;encrypt=false;trustServerCertificate=true;";
        String username = "sa";
        String password = "hello";

        try (Connection conn = DriverManager.getConnection(url, username, password)) {
            System.out.println("✅ 成功连接至 SQL Server！");
            try (Statement stmt = conn.createStatement();
                 ResultSet rs = stmt.executeQuery("SELECT @@VERSION")) {
                if (rs.next()) System.out.println("SQL Server 版本: " + rs.getString(1));
            }
        } catch (SQLException e) {
            System.err.println("❌ 连接失败：" + e.getMessage());
            e.printStackTrace();
        }
    }
}

? 补充：如何 100% 确认实例名与服务器名？

• 打开 SQL Server Management Studio (SSMS) → 连接时，“服务器名称”输入框中显示的即为完整地址（如 LAPTOP-0CSKUFIE 或 LAPTOP-0CSKUFIE\\SQLEXPRESS）。
• 在 SSMS 查询窗口执行：

  SELECT @@SERVERNAME AS 'ServerName', 
         SERVERPROPERTY('InstanceName') AS 'InstanceName',
         SERVERPROPERTY('IsClustered') AS 'IsClustered';

总结：90% 的 JDBC 连接失败源于连接字符串未匹配实际服务配置。优先使用 localhost:1433 直连默认实例，关闭 SQL Server Browser 依赖，显式控制加密参数，并始终通过 SSMS 验证实例状态——这是最稳定、最易调试的实践路径。