如何从 RESTful API 正确传递错误？

问：

我指的是 Github 上的这个项目。因此，这应该是一个用于管理电影租赁服务的 RESTful API。我的意思是它现在在技术上“有效”，但它要做的一件事是将错误消息从内部方法直接传递给客户端。

以以下代码为例：

/*
GET films
*/
get("/films", (req, res) -> {
    try {
        String json_output = get_film_list();
        return json_output;
    } catch (Exception e) {
        return "{\"error\":\"There was an error: " + e.toString().replace("\"","") + "\"}";
    }
});

我们有方法：get_film_list()

public static String get_film_list()  throws SQLException, URISyntaxException{
    Connection connection = ConnectionPool.getDBCP2Connection();
    Statement stmt = connection.createStatement();
    ResultSet rs = stmt.executeQuery("SELECT * FROM films");

    String output = "{\"films\":[";
    int got_result = 0;
    while (rs.next()) {
        output += "{\"id\":\""+rs.getInt(1)+"\",\"name\":\""+rs.getString(2)+"\",\"type\":\""+rs.getInt(3)+"\"},";
        got_result = 1;
    }
    rs.close();
    stmt.close();
    output = output.substring(0, output.length()-1) + "]}";

    if (got_result == 1){
        return output;
    }else{
        throw new SQLException("No films.");
    }
}

因此，错误通过 API 传递给用户。我发现这对开发非常方便。我知道，如果服务器响应包含该属性，则会出现错误，并且它提供了错误消息。我通过代码审查听说这根本不是这样做的方法。我还怀疑也许你应该给出正式的 HTTP 错误或其他东西。但与此同时，我想我希望我的 api 始终返回漂亮的 JSON 格式字符串。error

当用户尚未进行身份验证时，他们将看到以下内容：

{“error”：“请进行身份验证。

我在数据库连接类中创建了一个错误，用户会看到以下内容：

{“error”：“出现错误：java.sql.SQLException：无法加载 JDBC 驱动程序类 'org.postgresql.Drive'“}

因此，我的问题归结为，使用 RESTful API 向用户返回错误消息的正确方法是什么。其中一种使用返回 JSON 数据。

谢谢！