Spring Boot测试@RestController时TestRestTemplate注入失败问题求助

我明白你遇到的困扰了——明明已经给@SpringBootTest加上了RANDOM_PORT的web环境配置，却还是没法注入TestRestTemplate，这个报错确实挺让人头疼的。咱们一步步来排查解决：

• 检查测试依赖是否齐全
  TestRestTemplate是Spring Boot Test Starter提供的组件，首先得确保你的项目依赖里包含了它：
  如果是Maven项目，确认pom.xml里有这段依赖：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
  </dependency>
  

  如果是Gradle项目，确认build.gradle里有：

  testImplementation 'org.springframework.boot:spring-boot-starter-test'
  

  依赖缺失或者版本不匹配，会导致Spring容器没法自动创建TestRestTemplate的Bean。

• 手动声明TestRestTemplate Bean（兜底方案）
  如果自动配置没生效，可以在测试类里手动定义这个Bean，强制让容器识别到它：

  @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
  final class ControllerTest {
      @LocalServerPort
      private int port;
  
      @Autowired
      private TestRestTemplate restTemplate;
  
      // 手动注册TestRestTemplate Bean
      @Bean
      public TestRestTemplate testRestTemplate() {
          return new TestRestTemplate();
      }
  
      @Test
      void invalidBigInteger1() {
          // 这里要注意！你的控制器路径是`/calc-simple`，但测试里写的是`/simple-calc`，路径不匹配后续也会失败哦
          final var testParams = new BigParameters("invalid", "6", List.of(), List.of(), 1);
          restTemplate.postForObject("http://localhost:" + port + "/calc-simple", testParams, BigResults.class);
      }
  }
  

• 检查测试类的包结构与启动类扫描范围
  Spring Boot默认会扫描主启动类所在包及其子包的组件，如果你的测试类不在这个范围内，自动配置的Bean可能没法被注入。解决方法有两个：

  1. 把测试类移到主启动类的子包下（比如主启动类在studio.abos.springcalc，测试类放在studio.abos.springcalc.rest就没问题）
  2. 在@SpringBootTest里显式指定主启动类，扩大扫描范围：

     @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT, classes = 你的主启动类.class)
     final class ControllerTest {
         // ... 其他代码
     }
     

• 排查自定义配置的干扰
  如果项目里有自定义的RestTemplate或TestRestTemplate配置类，比如用了@Primary注解或者自定义了Bean的创建条件，可能会覆盖Spring Boot的自动配置，导致容器里没有符合要求的TestRestTemplateBean。可以检查这些配置类，看看是不是限制了Bean的创建逻辑。

内容来源于stack exchange