Vaadin Flow+Spring Boot拆分后Servlet上下文无法找到资源求助

我之前拆分Vaadin单体应用到多模块结构时，也踩过几乎一模一样的资源加载坑，结合你的技术栈（Vaadin Flow Beta 8、Spring Boot 2.0.1.RELEASE、嵌入式Tomcat），给你几个针对性的排查和解决方向：

1. 先确认资源存放路径的正确性 #

Vaadin Flow 默认会从 META-INF/resources/VAADIN 目录加载静态资源（比如自定义主题、组件资源、静态文件等）。拆分后要注意：

• 如果是webapp模块独有的资源，放在 webapp/src/main/resources/META-INF/resources/VAADIN 下；
• 如果是common模块共享的资源，必须把资源放在 common/src/main/resources/META-INF/resources/VAADIN 目录，这样Maven打包时会把这些资源包含进common的jar包，webapp依赖common后才能正常读取。

划重点：别把Vaadin资源放在src/main/webapp下，Spring Boot嵌入式Tomcat对这个目录的处理逻辑和传统WAR包有差异，很容易导致上下文找不到资源。

2. 检查Spring Boot的资源扫描配置 #

多模块结构下，Spring Boot默认只扫描webapp模块的资源，需要手动配置让它识别其他模块的资源：
在webapp模块的application.properties中添加：

spring.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/

或者通过Java配置类自定义资源处理器，更精准地控制Vaadin资源路径：

@Configuration
public class VaadinResourceConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/VAADIN/**")
                .addResourceLocations("classpath:/META-INF/resources/VAADIN/");
    }
}

3. 验证Vaadin Servlet的上下文配置 #

确保webapp模块中Vaadin Servlet的映射和上下文配置没出错：

• 如果你用Spring Boot自动配置，要保证@SpringBootApplication注解在webapp模块的启动类上，并且扫描范围覆盖到其他模块（比如@SpringBootApplication(scanBasePackages = "com.yourcompany")）；
• 如果是手动注册VaadinServlet，检查Servlet的urlPatterns是否覆盖了资源路径，示例配置：

@Bean
public ServletRegistrationBean<VaadinServlet> vaadinServlet() {
    ServletRegistrationBean<VaadinServlet> registration = new ServletRegistrationBean<>(new VaadinServlet(), "/*");
    registration.setInitParameters(Collections.singletonMap(VaadinServlet.SERVLET_PARAMETER_PRODUCTION_MODE, "false"));
    return registration;
}

4. 排查Maven构建的资源打包问题 #

多模块下最容易忽略的就是资源是否被正确打包：

• 在common模块的pom.xml中，确保resources插件配置正确，没有遗漏资源目录：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
    </resources>
</build>

• 构建后解压common模块的jar包，检查META-INF/resources/VAADIN下是否有你要访问的资源；
• 确认webapp模块的pom.xml正确依赖了common模块，且依赖范围是compile或runtime。

5. 用日志定位问题 #

如果以上步骤都没解决，可以开启调试日志查看Vaadin实际尝试加载的路径：
在webapp模块的application.properties中添加：

logging.level.com.vaadin=DEBUG
logging.level.org.springframework.web.servlet.resource=DEBUG

启动应用后访问资源，看日志里的资源查找路径，就能精准定位到是哪个环节出了问题。

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