IntelliJ 如何调试Java应用内自建Jetty实例运行的JSP？

你遇到的场景和独立部署Jetty的差异，本质是Jetty的启动配置完全由你的应用代码控制，所有原本需要修改Jetty独立配置文件的参数，都要直接在代码里设置，没有独立的配置入口可以调整。之前JSP代码调不通断点的核心原因，通常是两个：一是JSP编译时没有输出带行号的调试信息，二是IDE和JSP编译临时目录的源码映射没有配对。

核心配置步骤 #

1. 在Jetty WebAppContext代码中开启JSP编译的调试支持 #

在你现有创建WebAppContext的代码块后，追加以下参数配置，这步是替代独立部署Jetty中修改webdefault.xml、start.ini的操作：

WebAppContext webAppContext = new WebAppContext();
webAppContext.setContextPath("/");
webAppContext.setResourceBase("src/webapps/qcksrv/");

// 追加JSP引擎调试相关配置
webAppContext.setInitParameter("classdebuginfo", "true"); // 这是*最容易被漏掉的核心参数*
webAppContext.setInitParameter("compilerSourceVM", "17"); // 替换为你当前运行的JDK版本对应值
webAppContext.setInitParameter("compilerTargetVM", "17");
// 指定JSP编译生成类的固定临时目录，避免目录随机变动导致IDE映射失效
File jspCompileTmp = new File("./.jetty-jsp-tmp");
jspCompileTmp.mkdirs();
webAppContext.setTempDirectory(jspCompileTmp);

默认内嵌Jetty的Jasper引擎不会强制要求编译时输出行号、本地变量信息，生成的JSP class文件不带调试符号，IDE哪怕连上了调试端口，也没法在JSP代码上触发断点。

2. 配置IDE的源码映射关系 #

因为你已经能调试应用自身的Java类，说明JVM启动时已经加载了JDWP调试代理（带-agentlib:jdwp相关启动参数），这部分不需要额外调整，只需要给JSP编译生成的类配对源码路径：

• IDEA操作：打开项目结构 -> 对应模块的源码配置页，将你JSP的实际存放目录（就是setResourceBase指向的src/webapps/qcksrv/）关联为JSP临时编译目录的源码。Jasper编译JSP时，会把所有JSP统一编译成org.apache.jsp包下的类，类名由原JSP路径转换而来，比如/user/list.jsp会编译成org.apache.jsp.user.list_jsp，这个类的实际源码就是你磁盘上的list.jsp文件。
• Eclipse操作：在对应远程调试配置的Source标签页中，手动添加你的JSP资源目录，排除掉不需要的类路径即可。

常见踩坑点 #

• 依赖缺失：Jetty 10及以上版本如果只引入jetty-webapp依赖，不带jetty-jsp的配套Jasper引擎依赖，会出现JSP能跑但没法编译、调试功能完全失效的问题，需要核对构建配置里的依赖版本和你当前Jetty实例的版本完全一致。
• 断点位置错误：JSP会把静态HTML片段编译成out.write()输出语句，打在纯HTML行、空白行的断点不会触发，必须把断点打在<% ... %>脚本段、<%= ... %>表达式的实际Java代码行上。
• 临时目录变动：如果不手动指定固定的JSP编译临时目录，Jetty默认会在系统临时目录下生成随机命名的文件夹，每次重启目录名都会变，IDE之前配的源码映射就会失效，需要重新配对。

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