java.sql.SQLException参数索引越界错误：含义与解决方案咨询

错误场景 #

开发员工请假申请JSP页面时，执行数据库插入操作触发异常：

java.sql.SQLException: Parameter index out of range (1 > number of parameters, which is 0)

错误页面请求URL：
http://localhost:8080/AdvancedEmployeeManagementSystem/AleaveEmp.jsp?leaveType=SickLeave&StartDate=2023-01-28&EndDate=2023-02-05&reason=s

对应代码片段：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%            
try {
    String username = (String)session.getAttribute("username");   
    String leaveType, startDate, endDate, reason;
    leaveType = request.getParameter("leaveType");
    startDate = request.getParameter("StartDate");
    endDate = request.getParameter("EndDate");
    reason = request.getParameter("reason");
                
    Class.forName("com.mysql.jdbc.Driver");
    Connection con = DriverManager.getConnection("jdbc:mysql://localhost:3306/mysql","root","12345");
    username = (String)session.getAttribute("username");                                          
    PreparedStatement pst = con.prepareStatement("insert into 'leave (leaveType,StartDate,EndDate,Reason) values (?,?,?,?)");

    pst.setString(1, leaveType);
    pst.setString(2, startDate);
    pst.setString(3, endDate);
    pst.setString(4, reason);
   
    int row = pst.executeUpdate();
            
    if(row==1)
    {
%>
<script>
    alert("Leave Applied");
</script>
<jsp:include page="profile.jsp"></jsp:include> 
<% }       
} catch(Exception e) {
    out.println(e);
}   
%>

错误含义 #

该异常表示：调用PreparedStatement的setString方法时，传入的参数索引（如1、2、3、4）超出了SQL语句中实际可识别的占位符?数量。SQL解析后发现语句里没有合法的占位符，但代码却尝试设置第1个参数，因此抛出此错误。

解决方法 #

核心问题修正 #

错误根源是SQL语句的表名格式错误：原SQL中表名leave被单引号'包裹，导致SQL解析器将'leave识别为字符串常量，后续的字段列表和?占位符都被解析错误，最终没有任何合法的占位符被识别。

修正后的SQL语句（二选一即可）：

// 方式1：直接使用表名（leave不是MySQL关键字，无需转义）
PreparedStatement pst = con.prepareStatement("insert into leave (leaveType,StartDate,EndDate,Reason) values (?,?,?,?)");

// 方式2：用反引号转义（适用于表名是关键字的场景）
PreparedStatement pst = con.prepareStatement("insert into `leave` (leaveType,StartDate,EndDate,Reason) values (?,?,?,?)");

额外优化建议 #

1. 删除冗余代码：代码中两次调用session.getAttribute("username")，但未将该变量用于数据库插入，可删除重复的那一行。
2. 添加资源关闭逻辑：在finally块中关闭PreparedStatement和Connection，避免数据库资源泄漏：

   finally {
       if (pst != null) {
           try { pst.close(); } catch (SQLException ignore) {}
       }
       if (con != null) {
           try { con.close(); } catch (SQLException ignore) {}
       }
   }
   

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