为何无法访问Spring Boot服务暴露的REST API？

1. 依赖配置错误 #

你在build.gradle里把spring-boot-starter-web加到了classpath中，这是错误的。spring-boot-starter-web是应用级依赖，应该放在dependencies块内，而非buildscript的classpath下。正确配置如下：

dependencies {
    compile group: 'org.springframework.boot', name: 'spring-boot-starter-web', version: '1.5.8.RELEASE'
    // 其他应用依赖...
}

注：Spring Boot 1.5.x版本使用compile声明依赖，更高版本才会用implementation。

2. 启动类与控制器类同名冲突 #

你的启动类和控制器类都命名为MyApplication，这会导致类加载冲突，Spring无法正确识别组件。请修改控制器类名称，例如改为MyApiController：

@RestController
public class MyApiController {

    @RequestMapping(method={RequestMethod.GET}, value="/myApi", produces=MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<String> myApiHandler() {
        return new ResponseEntity<String>("Successfully called API", HttpStatus.OK);
    }
}

3. 启动类注解冗余且可能冲突 #

@SpringBootApplication已经包含@Configuration、@EnableAutoConfiguration、@ComponentScan三个注解的功能，重复添加会导致配置异常。简化启动类代码：

@SpringBootApplication(exclude = { 
    DataSourceAutoConfiguration.class, 
    RibbonAutoConfiguration.class,
    ErrorMvcAutoConfiguration.class 
})
@EnableScheduling
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
    // 其他业务代码...
}

注：必须确保启动类包含main方法，这是Spring Boot应用的入口。

4. 验证服务是否真正启动 #

启动应用后，查看控制台日志，确认是否有Tomcat启动成功的标识，例如：

Tomcat started on port(s): 6069 (http)
Started MyApplication in X seconds (JVM running for X)

如果没有此类日志，说明应用启动失败，需排查日志中的错误信息（如依赖缺失、配置错误等）。

5. 端口占用检查 #

若服务已启动但仍无法连接，检查6069端口是否被其他进程占用：

• Windows系统：执行netstat -ano | findstr :6069
• Linux/macOS系统：执行lsof -i :6069
  若端口被占用，可杀掉占用进程，或修改application.properties中的server.port为其他未被占用的端口。

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