Java调用SQL Server存储过程获取返回值报错求助

问题背景 #

有如下SQL Server存储过程，用于验证用户名密码，通过RETURN返回bit类型的0或1：

ALTER PROCEDURE [dbo].[auth_user]
    @username nchar(50),
    @password nchar(50)
AS BEGIN
    DECLARE @response AS bit = 0;

    UPDATE dbo.Users
    SET @response = 1
    WHERE Username = @username
        AND Password = @password

    RETURN @response
END

对应的Java调用代码尝试用executeQuery()获取结果集，执行时报错：

com.microsoft.sqlserver.jdbc.SQLServerException: The statement did not return a result set.

Java代码片段：

Connection connection = null;
CallableStatement storedProcedure = null;
ResultSet resultSet = null;

// ... 省略连接获取代码

connection = Shop.OpenConnection();

storedProcedure = connection.prepareCall("{call auth_user(?, ?)}");
storedProcedure.setString(1, UsernameField.getText());
storedProcedure.setString(2, PasswordField.getText());

resultSet = storedProcedure.executeQuery(); // 报错行
if (resultSet.next()) {
    JOptionPane.showMessageDialog(null, "Correct username and password");
    MainFrame frame = new MainFrame();
    frame.setVisible(true);
} else {
    JOptionPane.showMessageDialog(null, "Wrong username or password");
}

错误原因 #

executeQuery()仅适用于返回结果集的SQL语句（比如SELECT），但当前存储过程是通过RETURN返回单个值，不会生成结果集，因此调用该方法会抛出异常。

解决方法 #

有两种可行的处理方式：

方式一：修改存储过程为输出参数推荐 #

SQL Server的RETURN通常用于返回执行状态码（0表示成功，非0表示错误），业务数据更适合用输出参数传递。修改存储过程如下：

ALTER PROCEDURE [dbo].[auth_user]
    @username nchar(50),
    @password nchar(50),
    @response bit OUTPUT -- 添加输出参数
AS BEGIN
    SET @response = 0;

    UPDATE dbo.Users
    SET @response = 1
    WHERE Username = @username
        AND Password = @password
END

对应的Java调用代码需要注册输出参数，然后执行并获取值：

Connection connection = null;
CallableStatement storedProcedure = null;

try {
    connection = Shop.OpenConnection();
    // 调用时声明输出参数的位置
    storedProcedure = connection.prepareCall("{call auth_user(?, ?, ?)}");
    storedProcedure.setString(1, UsernameField.getText());
    storedProcedure.setString(2, PasswordField.getText());
    // 注册第三个参数为输出参数，类型为BIT
    storedProcedure.registerOutParameter(3, java.sql.Types.BIT);

    // 执行存储过程，用execute()而非executeQuery()
    storedProcedure.execute();

    // 获取输出参数的值
    boolean isAuthenticated = storedProcedure.getBoolean(3);
    if (isAuthenticated) {
        JOptionPane.showMessageDialog(null, "用户名密码正确");
        MainFrame frame = new MainFrame();
        frame.setVisible(true);
    } else {
        JOptionPane.showMessageDialog(null, "用户名或密码错误");
    }
} catch (SQLException e) {
    e.printStackTrace();
    JOptionPane.showMessageDialog(null, "验证失败：" + e.getMessage());
} finally {
    // 关闭资源
    try {
        if (storedProcedure != null) storedProcedure.close();
        if (connection != null) connection.close();
    } catch (SQLException e) {
        e.printStackTrace();
    }
}

方式二：不修改存储过程，获取RETURN返回值 #

如果不能修改存储过程，可以通过注册返回参数来获取RETURN的值：

Connection connection = null;
CallableStatement storedProcedure = null;

try {
    connection = Shop.OpenConnection();
    // 注意调用语法：{? = call auth_user(?, ?)}，第一个?对应RETURN的值
    storedProcedure = connection.prepareCall("{? = call auth_user(?, ?)}");
    // 注册第一个参数为返回值，类型为BIT
    storedProcedure.registerOutParameter(1, java.sql.Types.BIT);
    storedProcedure.setString(2, UsernameField.getText());
    storedProcedure.setString(3, PasswordField.getText());

    // 执行存储过程
    storedProcedure.execute();

    // 获取返回值
    boolean isAuthenticated = storedProcedure.getBoolean(1);
    if (isAuthenticated) {
        JOptionPane.showMessageDialog(null, "用户名密码正确");
        MainFrame frame = new MainFrame();
        frame.setVisible(true);
    } else {
        JOptionPane.showMessageDialog(null, "用户名或密码错误");
    }
} catch (SQLException e) {
    e.printStackTrace();
    JOptionPane.showMessageDialog(null, "验证失败：" + e.getMessage());
} finally {
    // 关闭资源
    try {
        if (storedProcedure != null) storedProcedure.close();
        if (connection != null) connection.close();
    } catch (SQLException e) {
        e.printStackTrace();
    }
}

注意事项 #

• 无论哪种方式，都要使用execute()执行存储过程，而非executeQuery()。
• 记得在finally块中关闭数据库连接、CallableStatement等资源，避免资源泄漏。
• 存储过程中使用UPDATE来设置@response的方式可以优化，比如改用IF EXISTS(SELECT 1 FROM dbo.Users WHERE Username=@username AND Password=@password) SET @response=1，避免不必要的更新操作。

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