添加图片上传页面后出现Whitelabel Error Page问题求助

一、路由映射配置检查 #

• 确认UploadGui类的路由注解是否为@Route("/uploadImage")，Vaadin路由区分大小写，注意路径拼写
• 检查类上是否添加@Component或@SpringComponent注解，确保Spring能识别并加载这个Vaadin视图组件
• 查看项目启动控制台日志，寻找路由注册相关日志（如Registered route '/uploadImage' for xxx.UploadGui），若没有则说明组件未被扫描到

二、组件扫描范围验证 #

• 检查启动类的@SpringBootApplication注解，默认扫描启动类所在包及其子包，确认UploadGui是否在该范围内
• 若不在默认扫描范围，要么将UploadGui移至启动类所在包下，要么在启动类上添加@SpringBootApplication(scanBasePackages = {"xxx.your.package"})指定扫描路径

三、Spring Security权限配置检查 #

• 确保Security配置类中已允许访问/uploadImage路径，比如在configure(HttpSecurity http)方法中补充：

  http.authorizeRequests()
      .antMatchers("/test1", "/uploadImage").hasRole("USER")
      .antMatchers("/test2").hasRole("ADMIN")
      .antMatchers("/test3").hasAnyRole("USER", "ADMIN")
      .anyRequest().authenticated();
  

• 同时确认已开放Vaadin静态资源路径：/VAADIN/**、/frontend/**，否则上传组件的前端资源加载失败会导致页面报错

四、UploadGui类代码检查 #

• 确保类继承VerticalLayout/HorizontalLayout等Vaadin布局类，且组件初始化逻辑无异常，示例：

  @Route("/uploadImage")
  @SpringComponent
  @UIScope
  public class UploadGui extends VerticalLayout {
      public UploadGui() {
          MemoryBuffer buffer = new MemoryBuffer();
          Upload upload = new Upload(buffer);
          add(upload);
          // 其他组件初始化代码
      }
  }
  

• 启动项目时观察控制台，是否有UploadGui初始化时抛出的异常栈信息

五、依赖版本兼容性核查 #

• 确认pom.xml中Spring Boot与Vaadin版本匹配（如Spring Boot 2.7.x对应Vaadin 23.x，Spring Boot 3.x对应Vaadin 24.x），版本不兼容会导致路由注册失败
• 检查是否引入Vaadin上传组件依赖：

  <dependency>
      <groupId>com.vaadin</groupId>
      <artifactId>vaadin-upload-flow</artifactId>
  </dependency>
  

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