【已解决】Caused by: org.springframework.beans.BeanInstantiationException: Failed to instantiate[...]

当在构造方法中，需要用到@Autowired注解依赖注入的 bean 时，启动程序会出现 Caused by: java.lang.NullPointerException: null 空指针异常的报错，相关的部分代码实现以及报错内容如下：

相关部分代码实现：

@Service
public class UserService {
    private static Map<String, User> userMap = new HashMap<>(64);
    
    @Autowired
    private UserManager userManager;

    public UserService() {
        List<User> userList = userManager.queryAll();
        if (!CoreTool.isEmpty(userList)) {
            userList.forEach(user -> {
                userMap.put(user.getId(), user);
            });
        }
    }
}

报错内容：

Caused by: org.springframework.beans.BeanInstantiationException: Failed to instantiate [com.xxx.xxx.xxxService]: Constructor threw exception; nested exception is java.lang.NullPointerException

这是因为 Spring 在创建对象时，会先执行构造方法，然后再执行依赖注入(@Autowired)。因此，在构造方法内部访问依赖对象 xxxBean 时，依赖的对象还没有被注入，从而导致空指针异常。

为了能够在对象实例被创建之后，使用依赖注入的对象进行一些资源或者数据初始化的操作，可以采用两种方式解决这个问题：

1. 在构造方法中对依赖对象实例化，再进行额外的初始化操作。
2. 使用@PostConstruct注解标记一个方法，该方法会在对象实例被创建后、依赖对象被注入完成之后被自动调用。它通常用于执行一些初始化操作，确保在对象完全准备好之后进行特定的任务。

以 User 类为例，针对第一种方法，实现代码如下：

@Service
public class UserService {
    private static Map<String, User> userMap = new HashMap<>(64);
    
    private UserManager userManager;

    public UserService(UserManagerImpl userManagerImpl) {
    	userManager = userManagerImpl;
        List<User> userList = userManager.queryAll();
        if (!CoreTool.isEmpty(userList)) {
            userList.forEach(user -> {
                userMap.put(user.getId(), user);
            });
        }
    }
}

针对第二种方法，使用@PostConstruct注解，实现代码如下：

@Service
public class UserService {
    private static Map<String, User> userMap = new HashMap<>(64);
    
    @Autowired
    private UserManager userManager;
    
    @PostConstruct
    public init() {
    	userManager = userManagerImpl;
        List<User> userList = userManager.queryAll();
        if (!CoreTool.isEmpty(userList)) {
            userList.forEach(user -> {
                userMap.put(user.getId(), user);
            });
        }
    }
}

因此，从上面的代码可以得知，在执行顺序上：构造方法>@Autowired>@PostConstruct。

关于@PostConstruct注解简要介绍如下：

• 用途： @PostConstruct 注解用于指示一个方法在对象的构造函数执行后、依赖注入完成后被调用。这使得开发人员可以在对象完全初始化之后，执行一些额外的自定义初始化操作。
• 位置： @PostConstruct 注解可以用于类的实例方法上，但不可以用于静态方法、构造方法或者接口方法。
• 执行时机： 标记了 @PostConstruct 注解的方法会在对象创建和依赖注入完成后自动被调用。通常发生在对象实例化和依赖注入之后，但在该对象的业务方法之前。
• 避免空指针异常： 避免在构造函数中访问依赖对象时的空指针异常。如果在构造函数中访问依赖对象时，这些对象还没有被完全注入，因此使用 @PostConstruct 可以确保依赖对象已经准备好了。