Spring Boot应用控制器失效求助：启动正常但接口无响应

问题描述 #

应用启动状态正常，但所有接口访问均无响应。相关信息如下：

启动日志 #

[2m2023-04-22T03:23:17.326+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mc.alibou.security.SecurityApplication   [0;39m [2m:[0;39m Starting SecurityApplication using Java 17.0.6 with PID 55932 (D:\Descargas\spring-boot-3-jwt-security-main\spring-boot-3-jwt-security-main\target\classes started by luis_ in D:\Descargas\spring-boot-3-jwt-security-main\spring-boot-3-jwt-security-main)
[2m2023-04-22T03:23:17.328+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mc.alibou.security.SecurityApplication   [0;39m [2m:[0;39m No active profile set, falling back to 1 default profile: "default"
[2m2023-04-22T03:23:18.034+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mo.s.b.w.embedded.tomcat.TomcatWebServer [0;39m [2m:[0;39m Tomcat initialized with port(s): 8080 (http)
[2m2023-04-22T03:23:18.042+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mo.apache.catalina.core.StandardService  [0;39m [2m:[0;39m Starting service [Tomcat]
[2m2023-04-22T03:23:18.042+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mo.apache.catalina.core.StandardEngine   [0;39m [2m:[0;39m Starting Servlet engine: [Apache Tomcat/10.1.4]
[2m2023-04-22T03:23:18.128+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mo.a.c.c.C.[Tomcat].[localhost].[/]      [0;39m [2m:[0;39m Initializing Spring embedded WebApplicationContext
[2m2023-04-22T03:23:18.128+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mw.s.c.ServletWebServerApplicationContext[0;39m [2m:[0;39m Root WebApplicationContext: initialization completed in 761 ms
[2m2023-04-22T03:23:18.436+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mo.s.b.w.embedded.tomcat.TomcatWebServer [0;39m [2m:[0;39m Tomcat started on port(s): 8080 (http) with context path ''
[2m2023-04-22T03:23:18.444+02:00[0;39m [32m INFO[0;39m [35m55932[0;39m [2m---[0;39m [2m[           main][0;39m [36mc.alibou.security.SecurityApplication   [0;39m [2m:[0;39m Started SecurityApplication in 1.412 seconds (process running for 1.872)

主类代码 #

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, SecurityAutoConfiguration.class})
@ComponentScan("com.alibou.security.user")
public class SecurityApplication {

    public static void main(String[] args) {
        SpringApplication.run(SecurityApplication.class, args);
    }

}

项目结构 #

主类位于com.alibou.security包，控制器类位于com.alibou.security.controller子包。

控制器代码 #

@RestController
public class Controller {

    @GetMapping("/hello")
    public String helloWorld() {
        return "Hello World";
      }
}

访问情况 #

通过Postman访问http://localhost:8080/hello无任何响应。

解决思路 #

• 修复组件扫描范围：主类上的@ComponentScan仅指定了com.alibou.security.user包，导致Spring无法扫描到controller包下的控制器类，接口无法注册。直接移除@ComponentScan注解即可——因为@SpringBootApplication默认会扫描主类所在包及其所有子包，主类在com.alibou.security，控制器在其子包controller，移除后Spring能自动扫描到控制器。修改后主类代码：

  @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, SecurityAutoConfiguration.class})
  public class SecurityApplication {
  
      public static void main(String[] args) {
          SpringApplication.run(SecurityApplication.class, args);
      }
  
  }
  

• 验证端口与路径：从日志确认Tomcat启动端口为8080，上下文路径为空，访问地址http://localhost:8080/hello是正确的，排除路径错误问题。
• 检查网络与防火墙：确认本地防火墙未拦截8080端口，可尝试用浏览器直接访问接口，验证是否能正常响应。
• 添加调试日志：启动时查看日志中是否有控制器类的初始化记录，确认组件扫描是否生效，可搜索Controller类名定位相关日志。

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