Spring RequestMapping返回自动生成Vaadin HTML页面问题排查

核心原因 #

Vaadin框架默认会拦截并处理所有传入的HTTP请求，当你的Rest接口路径未被明确排除时，Vaadin会将其视为前端路由请求，返回自动生成的HTML入口页面。结合你提到RestController已被实例化的情况，重点从路径拦截和安全配置入手排查。

1. 配置Vaadin排除Rest接口路径 #

在Spring Boot环境下，通过两种方式让Vaadin忽略你的Rest接口路径（假设接口前缀为/api）：

• 配置文件方式
  在application.properties中添加：

  vaadin.url.excludes=/api/**
  

• 代码配置方式
  实现VaadinServiceInitListener动态排除路径：

  @Configuration
  public class VaadinRestExclusionConfig implements VaadinServiceInitListener {
      @Override
      public void serviceInit(ServiceInitEvent event) {
          event.getSource().addRequestHandler((session, request, response) -> {
              String path = ((VaadinServletRequest) request).getPathInfo();
              if (path != null && path.startsWith("/api/")) {
                  // 告知Vaadin不处理该请求，交由Spring MVC处理
                  return false;
              }
              return true;
          });
      }
  }
  

2. 检查Spring Security配置（若集成） #

如果使用了Spring Security，需确保Rest接口路径不被Vaadin安全过滤器拦截，同时允许匿名访问：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends VaadinWebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        super.configure(http);
        // 允许/api路径下的请求无需认证
        http.authorizeRequests()
            .antMatchers("/api/**")
            .permitAll();
    }
}

3. 确认RestController注解正确性 #

务必使用@RestController而非@Controller：

• @Controller会将返回值解析为视图名称，导致返回HTML页面；
• @RestController等价于@Controller + @ResponseBody，会直接将返回值序列化为JSON/文本响应。

示例正确写法：

@RestController
@RequestMapping("/api")
public class TestRestController {
    public TestRestController() {
        System.out.println("Created");
    }

    @PostMapping("/process")
    public ResponseEntity<String> handlePostRequest() {
        System.out.println("POST请求已触发");
        return ResponseEntity.ok("请求处理成功");
    }
}

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