Vaadin Spring Boot中@PostConstruct时ApplicationProperties为空的问题

问题分析 #

从日志和代码来看，核心矛盾是：MenuLayout的@PostConstruct执行时检测到ApplicationProperties为null，但后续日志显示ApplicationProperties已完成配置加载。结合Vaadin+Spring Boot的生命周期特性，问题根因如下：

1. 作用域不匹配：MenuLayout默认是单例@Component，而Vaadin的UI是每个用户请求独立实例化的，单例Bean初始化时VaadinSession尚未绑定，同时Vaadin可能在请求时创建非Spring管理的MenuLayout实例，导致依赖注入失效。
2. 初始化时机错误：@PostConstruct是Spring Bean初始化阶段执行，此时还未进入Vaadin的请求上下文，既拿不到VaadinSession，也无法保证依赖的配置Bean完全加载完成。
3. 手动加载配置的时序冲突：ApplicationProperties在构造器中手动读取配置文件，与Spring的Bean生命周期流程脱节，可能导致Bean实例已注入但配置数据尚未加载完毕。

解决方案 #

1. 修正MenuLayout的作用域与初始化时机

将MenuLayout改为UI作用域，通过Vaadin的组件附加事件初始化菜单，确保在VaadinSession和UI可用时执行逻辑：

import com.vaadin.flow.component.attach.AttachEvent;
import com.vaadin.flow.spring.annotation.UIScope;

@UIScope // 每个UI对应一个实例，适配Vaadin生命周期
@Component
public class MenuLayout extends HybridMenu implements RouterLayout {

    private static final long serialVersionUID = 1L;
    private static final Logger logger = Logger.getLogger(MenuLayout.class.getName());

    private final ApplicationProperties appProperties;

    // 构造器注入，Spring自动保证依赖先初始化
    public MenuLayout(ApplicationProperties appProperties) {
        this.appProperties = appProperties;
    }

    // 组件附加到UI时触发，此时VaadinSession/UI已绑定到当前线程
    @Override
    protected void onAttach(AttachEvent attachEvent) {
        super.onAttach(attachEvent);
        initMenu();
    }

    private void initMenu() {
        withConfig(new MenuConfig());
        getConfig().setTheme(ETheme.Lumo);

        if (appProperties != null) {
            setupMenuItems();
        } else {
            logger.log(Level.WARNING, "ApplicationProperties is null. Menu items will not be set up.");
        }
    }

    private void setupMenuItems() {
        // 你的菜单初始化逻辑
    }
}

2. 重构ApplicationProperties的配置加载方式

用Spring原生注解替代手动加载，确保配置加载与Bean生命周期同步：

package com.ricontrans.application.config;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Primary;
import org.springframework.context.annotation.PropertySource;
import org.springframework.stereotype.Component;

import java.util.*;
import java.util.logging.Level;
import java.util.logging.Logger;

@Primary
@Component
@PropertySource("classpath:configuration.properties") // 自动加载自定义配置文件
@ConfigurationProperties(prefix = "application") // 绑定前缀为application的配置项
public class ApplicationProperties {
    private final Map<String, Category> acceptedCategories = new HashMap<>();
    private final List<Description> descriptions = new ArrayList<>();
    private static final Logger logger = Logger.getLogger(ApplicationProperties.class.getName());

    public ApplicationProperties() {
        logger.log(Level.INFO, "ApplicationProperties bean initialized.");
    }

    // 配置加工逻辑移到@PostConstruct，确保配置绑定完成后执行
    @PostConstruct
    public void postLoadProcessing() {
        logger.log(Level.INFO, "Unique Categories with Folders: {0}", getUniqueCategoriesWithFolders());
    }

    // 保留原有的getter和内部类代码
    public Map<String, Category> getAcceptedCategories() {
        return acceptedCategories;
    }

    public List<Description> getDescriptions() {
        return descriptions;
    }

    public String getCategoryFolder(String categoryName) {
        Category category = acceptedCategories.get(categoryName);
        return category != null ? category.getFolder() : null;
    }

    public Map<String, List<String>> getUniqueCategoriesWithFolders() {
        Map<String, List<String>> categoryFoldersMap = new HashMap<>();

        acceptedCategories.values().forEach(category -> {
            String categoryName = category.getCategory();
            String folder = category.getFolder();

            if (categoryName != null && folder != null) {
                categoryFoldersMap.computeIfAbsent(categoryName, k -> new ArrayList<>()).add(folder);
            }
        });

        return categoryFoldersMap;
    }

    // Category和Description内部类代码不变
    public static class Category { /* ... */ }
    public static class Description { /* ... */ }
}

3. 清理无效注解

移除MenuLayout上的@Lazy和@DependsOn注解：

• @UIScope已实现延迟初始化（仅当UI创建时实例化）
• Spring构造器注入会自动保证依赖Bean优先初始化，无需@DependsOn

验证要点 #

1. 启动应用后，日志应先输出ApplicationProperties bean initialized.，再出现菜单初始化相关日志
2. 访问应用时，菜单应正确加载configuration.properties中的配置项
3. 确认不再出现ApplicationProperties is null的警告

内容的提问来源于stack exchange，提问作者Konstantinos Gkogkos