Из-за чего может возникнуть ситуация, когда Bean не создается

Spring Bean: причины неудачного создания и диагностика

Что такое Bean в Spring

Bean — это объект, управляемый Spring контейнером (IoC контейнер). Spring автоматически создаёт, инициализирует и внедряет зависимости в Bean'ы.

Основные причины, по которым Bean не создаётся

1. Bean не отмечен соответствующей аннотацией

// ❌ Плохо: обычный класс, Spring не знает о нём
public class UserService {
    public void save() { }
}

// Spring контейнер НЕ создаст Bean
UserService service = applicationContext.getBean(UserService.class);  // ОШИБКА!
// org.springframework.beans.factory.NoSuchBeanDefinitionException

// ✅ Хорошо: добавляем аннотацию
@Service  // или @Component, @Repository, @Controller
public class UserService {
    public void save() { }
}

// Теперь Spring создаст Bean автоматически
UserService service = applicationContext.getBean(UserService.class);  // OK

Нужные аннотации:

@Component              // Базовая аннотация для любого Bean
@Service                // Для бизнес-логики (часть application слоя)
@Repository             // Для работы с БД (часть infrastructure слоя)
@Controller             // Для веб-контроллеров (часть presentation слоя)
@RestController         // Для REST API контроллеров
@Configuration          // Для конфигурационных классов

2. Класс находится вне пакета сканирования

Spring сканирует только пакеты, указанные в @SpringBootApplication или @ComponentScan:

Проект структура:
my-app/
├── com.example.myapp/                    ← Base package
│   ├── Application.java                  ← @SpringBootApplication
│   ├── controller/
│   │   └── UserController.java           ✅ Будет отсканирован
│   ├── service/
│   │   └── UserService.java              ✅ Будет отсканирован
├── com.external.lib/                     ← Другой пакет
│   └── ExternalService.java              ❌ НЕ будет отсканирован

// ❌ Проблема: класс вне сканируемого пакета
// com.external.lib.ExternalService
public class ExternalService {
    @Component
    public static class MyBean {}  // Даже с @Component не будет создан
}

// ✅ Решение: явно указать пакет
@SpringBootApplication
@ComponentScan(basePackages = {"com.example.myapp", "com.external.lib"})
public class Application {}

3. Циклические зависимости (Circular Dependencies)

@Service
public class ServiceA {
    @Autowired
    private ServiceB serviceB;  // ServiceA зависит от ServiceB
}

@Service
public class ServiceB {
    @Autowired
    private ServiceA serviceA;  // ServiceB зависит от ServiceA
    
    // Получается:
    // A → B → A → B → ... (бесконечный цикл)
}

// ОШИБКА при запуске:
// org.springframework.beans.factory.BeanCurrentlyInCreationException:
// Error creating bean with name 'serviceA':
// Requested bean is currently in creation: Is there an unresolvable circular reference?

// ✅ Решение 1: использовать Setter Injection вместо Constructor Injection
@Service
public class ServiceB {
    private ServiceA serviceA;
    
    @Autowired
    public void setServiceA(ServiceA serviceA) {
        this.serviceA = serviceA;
    }
}

// ✅ Решение 2: использовать Lazy Initialization
@Service
public class ServiceA {
    @Autowired
    @Lazy
    private ServiceB serviceB;  // Bean создастся только при использовании
}

// ✅ Решение 3: переделать архитектуру (лучший вариант)
@Service
public class ServiceC {
    @Autowired private ServiceA serviceA;
    @Autowired private ServiceB serviceB;
    
    public void doSomething() {
        serviceA.doA();
        serviceB.doB();
    }
}

4. Отсутствуют требуемые зависимости

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;  // Этот Bean не существует!
}

@Component
public class UserService {
    @Autowired
    private DatabaseConnection dbConnection;  // Этого Bean'а нет
}

// ОШИБКА:
// org.springframework.beans.factory.NoSuchBeanDefinitionException:
// No qualifying bean of type 'DatabaseConnection' available

// ✅ Решение 1: создать недостающий Bean
@Repository
public class UserRepository {
    public User findById(Long id) { return null; }
}

// ✅ Решение 2: указать конкретную реализацию через @Qualifier
@Service
public class UserService {
    @Autowired
    @Qualifier("mysqlUserRepository")
    private UserRepository userRepository;
}

@Repository("mysqlUserRepository")
public class MysqlUserRepository implements UserRepository {}

5. Исключение при инициализации Bean'а

@Service
public class ConfigService {
    private String apiKey;
    
    public ConfigService() {
        // Исключение при создании Bean'а
        this.apiKey = System.getenv("API_KEY");
        if (apiKey == null) {
            throw new RuntimeException("API_KEY не установлен");  // ❌ Bean не создан
        }
    }
}

// ОШИБКА при запуске:
// org.springframework.beans.factory.BeanCreationException:
// Error creating bean with name 'configService':
// Instantiation of bean failed; nested exception is java.lang.RuntimeException:
// API_KEY не установлен

// ✅ Решение 1: использовать @Value аннотацию
@Service
public class ConfigService {
    @Value("${api.key:default-key}")
    private String apiKey;
    
    public ConfigService() {
        // Конструктор вызывается, @Value внедряется позже
    }
}

// ✅ Решение 2: использовать @PostConstruct
@Service
public class ConfigService {
    private String apiKey;
    
    @PostConstruct
    public void init() {
        this.apiKey = System.getenv("API_KEY");
        if (apiKey == null) {
            throw new RuntimeException("API_KEY не установлен");
        }
    }
}

6. Условное создание Bean'а через @ConditionalOnProperty

@Service
@ConditionalOnProperty(name = "feature.enabled", havingValue = "true")
public class OptionalService {
    // Этот Bean создастся только если feature.enabled=true
}

// В application.properties
// feature.enabled=false
// → Bean НЕ будет создан

// ❌ Ошибка, если пытаться получить:
OptionalService service = applicationContext.getBean(OptionalService.class);
// org.springframework.beans.factory.NoSuchBeanDefinitionException

// ✅ Решение: проверить наличие Bean'а
if (applicationContext.containsBean("optionalService")) {
    OptionalService service = applicationContext.getBean(OptionalService.class);
} else {
    // Bean не создан, используем альтернативу
}

7. Bean создан как Singleton, но требуется новый экземпляр

@Service  // По умолчанию Scope = SINGLETON
public class RequestProcessor {
    private String requestId = UUID.randomUUID().toString();
    
    public String getRequestId() {
        return requestId;  // Всегда один и тот же ID!
    }
}

// ❌ Проблема: все запросы используют один и тот же Bean
RequestProcessor proc1 = applicationContext.getBean(RequestProcessor.class);
RequestProcessor proc2 = applicationContext.getBean(RequestProcessor.class);
System.out.println(proc1 == proc2);  // true (один объект)

// ✅ Решение: использовать @Scope
@Service
@Scope(BeanDefinition.SCOPE_PROTOTYPE)  // Новый экземпляр каждый раз
public class RequestProcessor {
    private String requestId = UUID.randomUUID().toString();
}

// Теперь
RequestProcessor proc1 = applicationContext.getBean(RequestProcessor.class);
RequestProcessor proc2 = applicationContext.getBean(RequestProcessor.class);
System.out.println(proc1 == proc2);  // false (разные объекты)

Диагностика проблем с Bean'ами

// Способ 1: проверить все Bean'ы
String[] beanNames = applicationContext.getBeanDefinitionNames();
for (String name : beanNames) {
    System.out.println(name);  // Выводит все Bean'ы в контейнере
}

// Способ 2: проверить определение Bean'а
BeanDefinition bd = applicationContext.getBeanDefinition("userService");
System.out.println("Scope: " + bd.getScope());
System.out.println("Class: " + bd.getBeanClassName());

// Способ 3: включить DEBUG логирование
// application.properties
logging.level.org.springframework.beans=DEBUG
logging.level.org.springframework.context=DEBUG

Таблица: частые ошибки и решения

Вывод

Bean не создаётся когда:

1. Класс не помечен аннотацией (@Component, @Service, etc.)
2. Класс вне сканируемого пакета
3. Циклические зависимости между Bean'ами
4. Отсутствуют требуемые зависимости
5. Исключение при инициализации
6. Условное создание не выполнено (@ConditionalOnProperty)
7. Неверная конфигурация Scope

Большинство проблем решаются анализом логов и использованием DEBUG уровня логирования.