运行Spring官方RESTful Web Service Maven示例项目遇404 Whitelabel错误求解
运行Spring官方rest-service示例触发404白页的修复方案
Whitelabel Error Page是Spring Boot未匹配到请求路径时的默认兜底提示,本质是请求路径与已注册的Controller映射未匹配上,按以下维度逐一排查即可定位修复:
- 排查组件扫描范围错位问题
Spring Boot默认会从@SpringBootApplication启动类所在的包路径开始,向下扫描所有带@Component、@Controller、@RestController注解的类完成容器注册。从官方克隆项目时如果调整了包结构,很容易出现扫描漏配:- 需确保启动类处于所有业务类的最上层包路径,比如启动类放在
com.example.restservice包下时,GreetingController必须放在com.example.restservice的子包,或者和启动类同包 - 检查控制器类的注解配置,确认
GreetingController正确标注了@RestController,没有漏注解、错写为普通组件注解的问题 - 临时验证可在启动类上显式指定扫描路径:
@ComponentScan(basePackages = "你实际存放Controller的包路径"),重启后如果接口可正常访问,即可确认是扫描范围不对
- 需确保启动类处于所有业务类的最上层包路径,比如启动类放在
- 核对接口实际映射路径
官方gs-rest-service示例中,GreetingController的接口映射路径是/greeting,不存在根路径/的映射逻辑。如果直接在浏览器访问http://localhost:8080,必然触发404错误,正确访问格式为http://localhost:8080/greeting,可附带?name=xxx参数返回自定义问候内容。 - 检查服务配置项匹配偏差
打开src/main/resources/application.properties,核对两项易导致404的配置:- 检查
server.port配置值,确认启动端口是否和浏览器访问的端口一致;如果本地8080端口被占用,Spring Boot会自动切换为其他端口,需要替换成控制台实际启动的端口值 - 检查是否存在
server.servlet.context-path配置,一旦配置了上下文路径,所有接口都需要在路径前拼接该前缀。可直接参考启动时控制台打印的日志,日志会明确标注Tomcat started on port(s): xxxx (http) with context path '/xxx',按照日志标注的端口、上下文路径拼接口地址即可
- 检查
- 确认Web依赖加载完整性
检查项目pom.xml依赖配置,确认引入了spring-boot-starter-web依赖,不要错引入不带Web内嵌容器、MVC组件的基础spring-boot-starter依赖。如果依赖存在缓存损坏问题,执行mvn clean install -U强制拉取全量依赖后重新启动项目。
快速定位技巧:在application.properties中添加配置
logging.level.org.springframework.web.servlet.mvc.method.annotation=DEBUG,启动后控制台会打印所有被成功注册的接口映射路径,直接对照日志中的路径访问,可避免路径拼写、注册漏配类问题。
内容的提问来源于stack exchange,提问作者tunayvaz
相关产品推荐
相关产品推荐

