在 Spring Boot 工程编译时遇到maven-surefire-plugin的测试执行失败错误（Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:3.5.3:test），通常与测试环节相关。以下是常见原因及解决方法：

1. 测试用例执行失败

• 原因：最常见的是测试用例（*Test.java）运行时抛出异常（如断言失败、空指针等），导致 Surefire 插件执行中断。

• 解决：

◦ 查看错误日志中更详细的堆栈信息，找到具体失败的测试类和方法（通常在[ERROR] Tests run: X, Failures: Y, Errors: Z之后）。

◦ 修复对应测试用例的逻辑错误，确保测试能正常通过。

2. 测试依赖或环境问题

• 原因：测试代码依赖的类、配置或外部资源（如数据库、服务）缺失或异常，导致测试无法运行。

• 解决：

◦ 检查测试类中是否引用了未正确初始化的资源（如@Autowired的 Bean 未加载）。

◦ 确保测试环境依赖（如数据库）已启动，或使用@Mock等注解模拟依赖。

◦ 若使用 Spring Boot 测试，确保测试类标注了@SpringBootTest，且上下文能正常加载。

3. Surefire 插件版本或配置冲突

• 原因：插件版本与 JDK、Spring Boot 版本不兼容，或配置有误（如测试类路径、排除规则等）。

• 解决：

◦ 检查版本兼容性：Spring Boot 通常会管理 Surefire 插件版本，建议移除手动指定的版本，使用 Spring Boot 父工程的默认版本：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <!-- 移除version，使用spring-boot-starter-parent管理的版本 -->
    </plugin>
  </plugins>
</build>

◦ 排除特定测试：若某些测试暂时无需执行，可配置插件跳过：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <!-- 排除单个测试类 -->
    <excludes>
      <exclude>**/ProblematicTest.java</exclude>
    </excludes>
  </configuration>
</plugin>

4. 临时跳过测试环节

• 若需紧急编译打包，可临时跳过测试（不推荐长期使用，需确保测试最终能通过）：

◦ 命令行执行：mvn clean package -DskipTests（跳过测试执行，但编译测试代码）

◦ 或：mvn clean package -Dmaven.test.skip=true（完全跳过测试代码的编译和执行）

5. 其他常见问题

• JDK 版本问题：确保 JDK 版本与 Surefire 插件兼容（如 JDK 17 + 建议使用 Surefire 3.0+）。

测试类命名不符合规范：默认情况下，Surefire 只执行命名为*Test.java、Test*.java、*Tests.java的类，若测试类命名不符，会被忽略（但不会报错，需结合具体日志判断）。

关键步骤

1. 仔细查看错误日志中紧跟在错误提示后的具体测试失败信息（堆栈跟踪），定位问题根源。

2. 优先修复测试用例的逻辑或环境依赖问题，确保测试可正常运行。

3. 若涉及插件配置，尽量遵循 Spring Boot 的默认配置，避免版本冲突。

最终经过一系列的排查，原因是TlsSocketStrategy.class 文件的缺失导致，由于httpclient5:5.3版本及以下不存在该类文件。

所以将httpclient5的依赖版本直接升级到5.4或者更高版本问题即可街道解决。

<!-- 核心 HTTP 客户端功能 -->
    <dependency>
        <groupId>org.apache.httpcomponents.client5</groupId>
        <artifactId>httpclient5</artifactId>
        <version>5.4</version>
    </dependency>