生成Jasper报表时遭遇NoClassDefFoundError问题求助

我正尝试基于MySQL数据库数据创建Jasper报表，Servlet代码如下：

Class.forName("com.mysql.jdbc.Driver");
Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/db", "root","");
JasperReport jasperReport = null;
JasperDesign jasperDesign = null;
//Map parameters = new HashMap();
int region = 1;
            
//String region = request.getParameter("region_code"); 
            
String Query = "SELECT * FROM areas where = '"+region+"'"; 
Map<String, Object> map = new HashMap<>();
map.put("queryAreas", Query);
String path = getServletContext().getRealPath("/WEB-INF/");
jasperDesign = JRXmlLoader.load(path + "/Reports/Areas.jrxml");
JRDesignQuery UpdateQuery = new JRDesignQuery();
UpdateQuery.setText(Query);
jasperDesign.setQuery(UpdateQuery);

jasperReport = JasperCompileManager.compileReport(jasperDesign);

JasperPrint jPrint = JasperFillManager.fillReport(jasperReport, null, conn);
JasperViewer.viewReport(jPrint);

System.out.println("Report generated!");

运行代码时触发以下错误：

Exception

javax.servlet.ServletException: Servlet execution threw an exception
    org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)
Root Cause

java.lang.NoClassDefFoundError: net/sf/jasperreports/engine/xml/JRXmlLoader
    Reports.Areas.doGet(Areas.java:45)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:670)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:779)
    org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)
Root Cause

java.lang.ClassNotFoundException: net/sf/jasperreports/engine/xml/JRXmlLoader
    org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1412)
    org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1220)
    Reports.Areas.doGet(Areas.java:45)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:670)
    javax.servlet.http.HttpServlet.service(HttpServlet.java:779)
    org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)

我已在IDE中导入所有所需库，代码编译无报错，但Tomcat运行时出现该问题，求解决。

核心问题定位 #

ClassNotFoundException说明Tomcat运行时无法找到JRXmlLoader类，本质是IDE构建路径中的库没有被部署到Tomcat的WEB-INF/lib目录——IDE仅用这些库完成编译，但Web应用运行时需要从WEB-INF/lib加载依赖类。

具体修复步骤 #

• 将所有JasperReports相关依赖jar包（包括核心包jasperreports-x.x.x.jar及其依赖的commons-collections、commons-logging等库）复制到项目的WEB-INF/lib目录下。
• 清理Tomcat工作目录（路径一般为Tomcat安装目录/work/Catalina/localhost/你的项目名称），删除目录内所有内容后重新部署项目，避免缓存导致的类加载异常。
• 检查IDE部署配置，确保项目部署时WEB-INF/lib目录会同步到Tomcat的webapps目录中。

额外代码修复提示 #

你的SQL语句存在语法错误：

String Query = "SELECT * FROM areas where = '"+region+"'"; 

缺少查询字段名，假设你要根据region_code过滤，需修改为：

String Query = "SELECT * FROM areas where region_code = '"+region+"'"; 

否则后续执行SQL会触发语法错误。

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