关于maven依赖中的<scope>provided</scope>使用

最新推荐文章于 2025-06-16 16:38:07 发布

转载最新推荐文章于 2025-06-16 16:38:07 发布 · 2k 阅读

java基础/js 专栏收录该内容

184 篇文章

订阅专栏

本文介绍了在Maven项目中如何正确使用<scope>provided</scope>来避免部署时因依赖冲突导致的问题。例如，在使用servlet-api时，如果服务器如Tomcat已自带该API，则可以通过设置<scope>provided</scope>来告知Maven编译器仅在编译阶段使用此依赖。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

关于maven依赖中的<scope>provided</scope>使用

小麋鹿666 2017-01-06 18:07:00 浏览57 评论0

摘要：今天开发web的时候，需要用到servlet-api，于是在pom.xml中添加依赖 <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>3.

今天开发web的时候，需要用到servlet-api，于是在pom.xml中添加依赖

<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>3.0-alpha-1</version>
        </dependency>

通过插件启动tomcat的时候，报错，里面有一段是这样的：

Caused by: java.lang.LinkageError: loader constraint violation: loader (instance of org/apache/catalina/loader/WebappClassLoader) previously initiated loading for a different type with name "javax/servlet/ServletContext"
    at java.lang.ClassLoader.defineClass1(Native Method)
    at java.lang.ClassLoader.defineClass(ClassLoader.java:800)
    at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
    at java.net.URLClassLoader.defineClass(URLClassLoader.java:449)
    at java.net.URLClassLoader.access$100(URLClassLoader.java:71)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:361)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:355)

产生的原因是：tomcat中也有servlet-api包，这样，发生了冲突

解决方法：添加<scope>provided</scope>，因为provided表明该包只在编译和测试的时候用，所以，当启动tomcat的时候，就不会冲突了，完整依赖如下：

<dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>3.0-alpha-1</version>
            <scope>provided</scope>
        </dependency>