Vaadin UI作用域未激活异常：多模块Spring Boot项目启动报错

核心原因 #

启动阶段Spring会初始化MainLayout，但此时Vaadin的UI实例尚未创建，vaadin-ui作用域未激活，直接在构造函数注入@UIScope标记的Bean会触发ScopeNotActiveException。

方案1：使用延迟注入（Provider） #

通过Spring的ObjectProvider延迟获取@UIScope组件，避免启动时强制初始化：

@RouteLayout
public class MainLayout extends AppLayout {
    private final ObjectProvider<BreadCrumb> breadCrumbProvider;
    private final ObjectProvider<VersionInfo> versionInfoProvider;

    // 构造注入Provider
    public MainLayout(ObjectProvider<BreadCrumb> breadCrumbProvider, ObjectProvider<VersionInfo> versionInfoProvider) {
        this.breadCrumbProvider = breadCrumbProvider;
        this.versionInfoProvider = versionInfoProvider;
    }

    // 在UI就绪后（比如导航完成钩子）获取实例
    @Override
    protected void afterNavigation() {
        BreadCrumb breadCrumb = breadCrumbProvider.getObject();
        VersionInfo versionInfo = versionInfoProvider.getObject();
        addToNavbar(breadCrumb);
        addToFooter(versionInfo);
    }
}

方案2：调整组件作用域 #

如果组件不需要绑定到单个UI实例（比如VersionInfo可会话共享），将@UIScope替换为@VaadinSessionScope或@SessionScope：

@VaadinSessionScope
@Component
public class VersionInfo extends Div {
    // 组件逻辑
}

Spring会为会话作用域Bean生成代理，延迟到首次使用时初始化，规避启动时的作用域问题。

方案3：结合@Autowired与@Lazy #

在注入字段上添加@Lazy，让Spring创建懒加载代理，直到首次调用时才初始化@UIScope组件：

@RouteLayout
public class MainLayout extends AppLayout {
    @Autowired
    @Lazy
    private BreadCrumb breadCrumb;

    @Autowired
    @Lazy
    private VersionInfo versionInfo;

    public MainLayout() {
        // 不要在构造函数中直接操作组件
    }

    @Override
    protected void afterNavigation() {
        addToNavbar(breadCrumb);
        addToFooter(versionInfo);
    }
}

方案4：让Vaadin主导MainLayout创建 #

确保MainLayout仅作为Vaadin路由布局，不被Spring提前实例化：

1. 移除MainLayout上的@Component注解（如果存在）
2. 保留@RouteLayout，让Vaadin在用户首次访问路由时创建实例，此时UI作用域已激活：

@RouteLayout
public class MainLayout extends AppLayout {
    private final BreadCrumb breadCrumb;
    private final VersionInfo versionInfo;

    // 此时注入@UIScope组件不会报错
    public MainLayout(BreadCrumb breadCrumb, VersionInfo versionInfo) {
        this.breadCrumb = breadCrumb;
        this.versionInfo = versionInfo;
        addToNavbar(breadCrumb);
        addToFooter(versionInfo);
    }
}

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