SpringBoot支持JSP访问，启动报错java.lang.NoClassDefFoundError: javax/servlet/ServletContext

快来打我* 2022-05-18 08:39 65阅读 0赞

# SpringBoot支持JSP简介 #

## 前言： ##

这篇文章中, 我们将使用IntelliJ IDEA开发一个带有Spring Boot所提供的内嵌tomcat的Spring MVC 应用程序示例。 示例源码是官网下载下来。记录一下所踩过的坑。有什么疑问可以在评论区提问，谢谢。

## 环境： ##

JDK1.8

IntelliJ IDEA/Eclipse

Maven

Spring Boot 1.5.6

Spring Boot与Apache Maven 3.2兼容。  
Maven 依赖  
spring-boot-starter-parent:    
提供了依赖关系管理，可以省略已存在依赖的版本标签。  
并声明一个或多个“启动器”的依赖关系。Spring Boot还提供了一个可选的 Maven插件来创建可执行的jar。

`spring-boot-starter-parent`是使用Spring Boot的好方法，但它可能不适合所有的时间。有时您可能需要从不同的父POM

继承，或者您可能不喜欢我们的默认设置。请参见 [第13.2.2节“使用不带父POM的Spring Boot”][13.2.2_POM_Spring Boot]作为使用`import` 范围的替代解

决方案。

spring-boot-starter-web: 包括了创建一个web应用程序的所有依赖。 这将避免列出不同的Spring常见的项目的版本（译注：项Web项目可能需要添加大量的依赖）。

spring-boot-starter-tomcat:默认情况下，启用一个内嵌的Apache Tomcat 7实例。 我们使用了我们定义的版本重写了这一点。 如果你需要部署War包在其他独立版本的Tomcat服务器上也可以标明。

tomcat-embed-jasper: 提供.jsp文件加载。

## 项目介绍： ##

首先，去官网翻阅了一下文档找到如下介绍，已经翻译过来,如下：![SouthEast][]

使用SpringBoot时对JSP有一些限制，然后官网有一个JSP示例，试着跑起来，目前官网推荐的springboot版本是1.5.6，

1.  `<span style="font-size:14px;"><parent>`
2.  `<groupId>org.springframework.boot</groupId>`
3.  `<artifactId>spring-boot-starter-parent</artifactId>`
4.  `<version>1.5.6.RELEASE</version>`
5.  `</parent></span>`

其它依赖：

1.  ``
2.  `<dependency>`
3.  `<groupId>javax.servlet</groupId>`
4.  `<artifactId>jstl</artifactId>`
5.  `</dependency>`
6.  ``
7.  `<dependency>`
8.  `<groupId>org.springframework.boot</groupId>`
9.  `<artifactId>spring-boot-starter-tomcat</artifactId>`
10. `<scope>provided</scope>`
11. `</dependency>`
12. `<dependency>`
13. `<groupId>org.apache.tomcat.embed</groupId>`
14. `<artifactId>tomcat-embed-jasper</artifactId>`
15. `<scope>provided</scope>`
18. `<dependency>`
19. `<groupId>org.springframework.boot</groupId>`
20. `<artifactId>spring-boot-starter-test</artifactId>`
21. `<scope>test</scope>`
22. `</dependency>`

然后试着去执行官网的JSP示例，使用的开发工具是IntellJ IDEA遇到了几个问题，如下介绍：

1、运行项目遇到了如下错误:

1.  `Caused by: java.lang.IllegalStateException: Failed to introspect annotated methods on class`
2.  `org.springframework.boot.web.support.SpringBootServletInitializer`
3.   
4.  `at org.springframework.core.type.StandardAnnotationMetadata.`
5.  `getAnnotatedMethods(StandardAnnotationMetadata.java:163) ~[spring-core-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
6.   
7.  `at org.springframework.context.annotation.ConfigurationClassParser.`
8.  `retrieveBeanMethodMetadata(ConfigurationClassParser.java:380) ~[spring-context-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
9.   
10. `at org.springframework.context.annotation.ConfigurationClassParser.`
11. `doProcessConfigurationClass(ConfigurationClassParser.java:314) ~[spring-context-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
12.  
13. `at org.springframework.context.annotation.ConfigurationClassParser.`
14. `processConfigurationClass(ConfigurationClassParser.java:245) ~[spring-context-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
15.  
16. `at org.springframework.context.annotation.ConfigurationClassParser.`
17. `parse(ConfigurationClassParser.java:198) ~[spring-context-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
18.  
19. `at org.springframework.context.annotation.ConfigurationClassParser.`
20. `parse(ConfigurationClassParser.java:167) ~[spring-context-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
21. `... 17 common frames omitted`
22.  
23. `Caused by: java.lang.NoClassDefFoundError: javax/servlet/ServletContext`
24. `at java.lang.Class.getDeclaredMethods0(Native Method) ~[na:1.8.0_111]`
25. `at java.lang.Class.privateGetDeclaredMethods(Class.java:2701) ~[na:1.8.0_111]`
26. `at java.lang.Class.getDeclaredMethods(Class.java:1975) ~[na:1.8.0_111]`
27. `at org.springframework.core.type.StandardAnnotationMetadata.getAnnotatedMethods`
28. `(StandardAnnotationMetadata.java:152) ~[spring-core-4.3.10.RELEASE.jar:4.3.10.RELEASE]`
29. `... 22 common frames omitted`
30.  
31. `Caused by: java.lang.ClassNotFoundException: javax.servlet.ServletContext`
32. `at java.net.URLClassLoader.findClass(URLClassLoader.java:381) ~[na:1.8.0_111]`
33. `at java.lang.ClassLoader.loadClass(ClassLoader.java:424) ~[na:1.8.0_111]`
34. `at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:331) ~[na:1.8.0_111]`
35. `at java.lang.ClassLoader.loadClass(ClassLoader.java:357) ~[na:1.8.0_111]`
36. `... 26 common frames omitted`
37.

google一番，查到了一些原因。

注意：

在Intellij IDEA中所有 scope 为 provided 的依赖都是不会被加入到 classpath 中的，目前该bug尚未被修复(([bug report][])。

如果你的web应用是部署到容器中的，那么这个bug不会影响使用，因为web应用中provided的依赖在容器运行时会被提供。

如果你做spring Boot开发，有带provided的依赖时，直接在IntellIJ IDEA中运行项目会导致ClassNotFound异常。

所以当jar需要被加入到classpath中需要注释<scope>provided</scope>，或者更改为：<scope>compile</scope>

Intellij Idea下运行Spring Boot关于provided依赖不加入classpath的bug与解决方案。其实这个错误有多种解决方案，下面就简单介绍一下最简单的解决方案：

![SouthEast 1][]

插件赖如下：

1.  `<plugin>`
2.  `<groupId>org.springframework.boot</groupId>`
3.  `<artifactId>spring-boot-maven-plugin</artifactId>`
4.  `</plugin>`

如运行报错,指定版本<version>version number</version>版本号显示红色说明插件相关文件没有下载下来或者没有下载完整。找到maven repository删除之前不完整或者文件夹即可，重新下载。这样就完美解决了之前的问题。

## 指定Application的working directory： ##

如上述还是不能访问jsp文件，或者报错404，原因如下，继续如下操作，指定working directory：

问题：  
在使用Intellij idea 时，如果配置文件放在project根目录下或者其他位置，往往会出现找不到配置文件的问题，而eclipse却不会出现这种问题。

解决方：

导致此问题的原因是因为Intellij idea 默认的根目录project的目录，而不是要运行的module目录。   
选择Edit Configurations–》Configuration–》Working directory，选择当前的module或者$MODULE\_DIR$，即可解决。详情如下图：

![SouthEast 2][]

## 注意： ##

`spring-boot-starter-web`包括`spring-boot-starter-tomcat`。你可以[在这里查看][Link 1]

在`spring-boot-starter-tomcat`包括`tomcat-embed-core`。你可以[在这里查看][Link 2]

但是，似乎`tomcat-embed-core`不包括`tomcat-embed-jasper`。其实是`tomcat-embed-jasper`谁包括依赖`tomcat-embed-core`。[在这里][Link 3]检查

无论如何，`tomcat-embed-jasper`标记为`provided`，所以表示您期望JDK或容器在运行时提供依赖关系。此范围仅适用于编译和测试类路径，不可传递。

总而言之，`spring-boot-starter-web`包括tomcat嵌入式的依赖关系，但它不包括jasper嵌入依赖关系，所以应该是单独声明的原因。

如有人遇到一样的问题，麻烦在评论区评论一下，谢谢。以上问题都是在使用IntelliJ IDEA的情况下所发生的错误及解决方案。项目也在eclipse运行过，没有以上问题出现。

文章来源：[https://blog.csdn.net/qq496013218/article/details/76241027][https_blog.csdn.net_qq496013218_article_details_76241027]

[13.2.2_POM_Spring Boot]: http://docs.spring.io/spring-boot/docs/1.5.6.RELEASE/reference/htmlsingle/#using-boot-maven-without-a-parent
[SouthEast]: /images/20220518/d1b2ef9861c84f9bba9f83cd243b23ff.png
[bug report]: https://youtrack.jetbrains.com/issue/IDEA-107048
[SouthEast 1]: /images/20220518/ca1623a3aa39425a99beb9d27b8aaba8.png
[SouthEast 2]: /images/20220518/641aea74efd4483b9184857f43f0ac20.png
[Link 1]: http://search.maven.org/#artifactdetails%7Corg.springframework.boot%7Cspring-boot-starter-web%7C1.5.1.RELEASE%7Cjar
[Link 2]: http://search.maven.org/#artifactdetails%7Corg.springframework.boot%7Cspring-boot-starter-tomcat%7C1.5.1.RELEASE%7Cjar
[Link 3]: http://search.maven.org/#artifactdetails%7Corg.apache.tomcat.embed%7Ctomcat-embed-jasper%7C9.0.0.M17%7Cjar
[https_blog.csdn.net_qq496013218_article_details_76241027]: https://blog.csdn.net/qq496013218/article/details/76241027