Maven传递依赖范围降级致Spring Boot运行时异常，求解决方案

一、修正依赖Scope（最根本的解决方式） #

• 若确认StringUtil是运行时必需的，直接将其依赖的scope从test改为compile（或runtime，如果仅运行时需要）：

  <dependency>
      <groupId>你的依赖groupId</groupId>
      <artifactId>string-util</artifactId>
      <version>对应版本号</version>
      <scope>compile</scope>
  </dependency>
  

• 若不想直接修改原依赖声明，可通过dependencyManagement强制统一该依赖的scope，覆盖所有间接引入的设置：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>你的依赖groupId</groupId>
              <artifactId>string-util</artifactId>
              <version>对应版本号</version>
              <scope>compile</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  

二、提前检测Scope异常，避免运行时踩坑 #

Maven默认不会警告这类问题，但可以用插件提前发现：

• 用maven-dependency-plugin分析依赖使用情况：

  mvn dependency:analyze
  

  执行后会输出Used undeclared dependencies或Unused declared dependencies，帮你快速定位test scope依赖被主代码间接引用的问题。
• 用maven-enforcer-plugin配置规则，构建时直接阻断异常依赖：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-enforcer-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
          <execution>
              <id>check-test-scope-leak</id>
              <goals>
                  <goal>enforce</goal>
              </goals>
              <configuration>
                  <rules>
                      <requireScope>
                          <message>Test scope依赖禁止被主代码间接引用</message>
                          <dependencies>
                              <dependency>
                                  <groupId>你的依赖groupId</groupId>
                                  <artifactId>string-util</artifactId>
                                  <scope>test</scope>
                              </dependency>
                          </dependencies>
                      </requireScope>
                  </rules>
              </configuration>
          </execution>
      </executions>
  </plugin>
  

三、Spring Boot Fat Jar临时补救方案（不推荐长期使用） #

如果暂时无法调整依赖，可强制让Spring Boot插件打包test scope依赖：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>你的Spring Boot版本</version>
    <configuration>
        <includeTestScope>true</includeTestScope>
    </configuration>
</plugin>

注意：此方法会打包所有test依赖，导致Jar体积膨胀，仅作为临时应急手段。

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