Eclipse WindowBuilder中JavaBeans自定义编辑器无法通过微软JDBC连接SQL Server

环境配置：

• Windows 10
• Eclipse IDE for Java Developers 2025-03
• WindowBuilder 1.20.0.202503172036
• JDK 1.8.0_201
• 微软SQL Server JDBC驱动12.10（mssql-jdbc-12.10.0.jre8.jar）
• SQL Server 13.0.7050.2

连接代码在main方法中可正常运行，但在WindowBuilder设计模式下调用时抛出StringIndexOutOfBoundsException，堆栈跟踪指向com.microsoft.sqlserver.jdbc.ConfigurableRetryLogic.getCurrentClassPath方法，原因是驱动解析ClassPath URI时处理异常。之前使用jTDS驱动可正常连接。

方法1：禁用JDBC驱动的重试逻辑 #

通过添加连接属性retryLogic=none，跳过ConfigurableRetryLogic类的初始化流程，避免URI解析错误。修改后的连接代码：

Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
java.util.Properties props = new java.util.Properties();
props.setProperty("password", "Mountbatten");
props.setProperty("userName", "Philip");
props.setProperty("databaseName", "Windsor");
props.setProperty("trustServerCertificate", "true");
// 添加禁用重试逻辑的属性
props.setProperty("retryLogic", "none");
String url = "jdbc:sqlserver://balmoral:2024";
java.sql.Connection conn = java.sql.DriverManager.getConnection(url, props);

方法2：降级微软JDBC驱动版本 #

该异常疑似12.10版本引入的bug，可降级到12.8或更早版本（如12.4），这些版本未包含有问题的ConfigurableRetryLogic URI解析逻辑，能在WindowBuilder环境下正常连接。

方法3：自定义连接工厂，根据运行环境切换驱动 #

由于jTDS驱动可在WindowBuilder下正常工作，可编写一个连接工厂类，检测当前是否处于WindowBuilder设计模式，自动切换驱动：

public class DbConnectionFactory {
    public static Connection getConnection() throws SQLException, ClassNotFoundException {
        // 判断是否处于WindowBuilder设计模式
        boolean isDesignMode = System.getProperty("eclipse.desktop") != null 
                || Thread.currentThread().getStackTrace()[1].getClassName().startsWith("org.eclipse.wb");
        
        if (isDesignMode) {
            // 设计模式下使用jTDS
            Class.forName("net.sourceforge.jtds.jdbc.Driver");
            String url = "jdbc:jtds:sqlserver://balmoral:2024/Windsor";
            java.util.Properties props = new java.util.Properties();
            props.setProperty("password", "Mountbatten");
            props.setProperty("user", "Philip");
            return DriverManager.getConnection(url, props);
        } else {
            // 运行时使用微软JDBC驱动
            Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
            java.util.Properties props = new java.util.Properties();
            props.setProperty("password", "Mountbatten");
            props.setProperty("userName", "Philip");
            props.setProperty("databaseName", "Windsor");
            props.setProperty("trustServerCertificate", "true");
            String url = "jdbc:sqlserver://balmoral:2024";
            return DriverManager.getConnection(url, props);
        }
    }
}

在WindowBuilder的JavaBeans编辑器中调用这个工厂类获取连接即可。

方法4：调整Eclipse启动参数修正ClassPath格式 #

在Eclipse的启动配置中添加VM参数，强制指定正确的ClassPath格式，避免驱动解析出错：

-Djava.class.path=C:\path\to\your\project\bin;C:\path\to\mssql-jdbc-12.10.0.jre8.jar

注意替换为实际的项目编译目录和驱动jar路径，此方法需要确保路径配置准确，维护成本较高。

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