Spring Boot 2.6.3+Vaadin23.2.5生产环境静态资源无法加载求助

1. Jar包中静态资源的正确存放位置是否需要修改Maven步骤？ #

不需要修改任何Maven配置或步骤。你当前的静态资源存放路径/src/main/resources/META-INF/resources完全符合Spring Boot和Vaadin的整合规范：

• Spring Boot默认会将该目录下的资源视为Web可访问的静态资源，打包时会自动将其放入Jar包的对应路径中；
• Vaadin在Spring Boot环境下也会优先识别这个路径的静态资源，和你之前使用Vaadin 23.0.10时的逻辑一致。

之前出现资源路径不匹配的问题，核心原因是@EnableWebMvc注解覆盖了Spring Boot的自动配置，导致Vaadin内置的资源映射规则被冲掉，系统转而使用了错误的资源查找路径。移除该注解后，Spring Boot和Vaadin的资源配置会协同工作，所以不需要调整Maven打包流程。

2. 如何实现并注册资源加载机制的委托器/拦截器用于调试日志？ #

可以从Spring MVC拦截和Vaadin日志调试两个维度来实现：

方式一：自定义Spring MVC资源拦截器 #

通过实现HandlerInterceptor来拦截所有资源请求，打印请求路径和资源查找细节：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.core.io.DefaultResourceLoader;
import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

public class ResourceDebugInterceptor implements HandlerInterceptor {
    private static final Logger log = LoggerFactory.getLogger(ResourceDebugInterceptor.class);

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        String requestUri = request.getRequestURI();
        log.debug("收到资源请求：{}", requestUri);

        // 针对Vaadin资源额外追踪查找路径
        if (requestUri.startsWith("/VAADIN/")) {
            ResourceLoader resourceLoader = new DefaultResourceLoader();
            try {
                // 尝试按正确路径查找资源
                Resource targetResource = resourceLoader.getResource("classpath:META-INF/resources" + requestUri);
                log.debug("尝试查找资源路径：{}，资源是否存在：{}", 
                          targetResource.getURL(), targetResource.exists());
            } catch (IOException e) {
                log.debug("查找资源失败：{}", requestUri, e);
            }
        }
        return true;
    }
}

然后通过WebMvcConfigurer注册拦截器（注意不要加@EnableWebMvc）：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebDebugConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new ResourceDebugInterceptor())
                .addPathPatterns("/**") // 拦截所有资源请求
                .excludePathPatterns("/VAADIN/build/**"); // 排除Vaadin编译后的静态资源，减少日志冗余
    }
}

方式二：开启Vaadin内置调试日志 #

直接调整日志级别，让Vaadin打印资源加载的详细过程，这是更简单的调试方式：
在application.properties中添加：

# 开启Vaadin静态资源处理器日志
logging.level.com.vaadin.flow.server.StaticResourceHandler=DEBUG
# 开启Vaadin Servlet请求处理日志
logging.level.com.vaadin.flow.server.VaadinServlet=DEBUG

这些日志会输出Vaadin处理资源请求时尝试的所有路径、资源是否找到等关键信息，快速定位路径匹配问题。

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