Spring应用运行正常但构建时提示RestTemplate Bean未找到，已定义该Bean

可能原因及对应解决步骤 #

1. 注入时未明确指定Bean名称 #

@Autowired默认按类型匹配，构建阶段若存在上下文加载顺序或潜在类型冲突问题，明确指定Bean名称可避免匹配失败：

@Autowired
@Qualifier("restTemplateBean")
RestTemplate restTemplateBean;

2. 主应用类扫描范围未覆盖服务层 #

确保主应用类的@SpringBootApplication注解覆盖服务层所在包。若服务层包不在主类同级或子包下，需手动指定扫描范围：

@SpringBootApplication(scanBasePackages = "com.yourpackage")
public class YourApplication {
    // 你的RestTemplate Bean定义
}

3. RestTemplate Bean因资源路径问题创建失败 #

构建阶段类路径资源访问逻辑与开发环境不同，原代码用file:src/main/resources/...的路径可能导致keystore文件找不到，进而Bean创建失败。改用ClassPathResource读取资源：

@Bean("restTemplateBean")
public RestTemplate restTemplateBean(RestTemplateBuilder builder) throws Exception {
    Resource keystoreResource = new ClassPathResource("itsm_qa_api-keystore.jks");
    SSLContext sslContext = new SSLContextBuilder()
            .loadTrustMaterial(keystoreResource.getFile(), "changeit".toCharArray()).build();

    SSLConnectionSocketFactory socketFactory = new SSLConnectionSocketFactory(sslContext);
    HttpClient httpClient = HttpClients.custom()
            .setSSLSocketFactory(socketFactory)
            .build();

    return builder
            .requestFactory(() -> new HttpComponentsClientHttpRequestFactory(httpClient))
            .build();
}

4. 构建时执行测试但测试上下文未加载主配置 #

若构建命令包含测试执行，而测试类未正确加载Spring上下文，会导致找不到Bean：

• 临时跳过测试构建：
  • Maven：mvn clean install -DskipTests
  • Gradle：gradle clean build -x test
• 若跳过测试后构建成功，需修改测试类确保加载主配置类：

@SpringBootTest(classes = YourApplication.class)
public class YourServiceTest {
    // 测试代码
}

5. 主应用类缺少必要注解 #

确认主应用类标注了@SpringBootApplication或@Configuration，否则其中的@Bean定义不会被Spring扫描到。

内容的提问来源于stack exchange，提问作者mamoon roshangar