springboot访问404解决办法

本文记录了一名开发者初次开发SpringBoot项目时遇到的404问题,重点揭示了两个常见误区:错误日志解读和DispatcherServlet配置。最后,作者发现问题是由于`@ComponentScan`注解导致的,只需正确配置即可。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

         第一次自主开发springboot项目,没想到一开始就这么受挫,不管访问什么路径都是404,几乎十二个小时都在找这个错误。

        并且排除:
                        路径写错
                        application类不和controller包在同一个包下

等问题后,如下解决方法可能会对你有所帮助。

误区1:

        在请求返回404的时候控制台不报错,一度以为是Initializing Spring DispatcherServlet 'dispatcherServlet'这个错误。原因是请求的时候返回404,只有控制台会多出来三行日志:所以一直在搜索Initializing Spring DispatcherServlet相关的报错。不过很遗憾,几乎找遍了所有的博客,依然没有解决问题。我也相信搜索行日志的兄弟们也碰到了这个问题,但是这里要说的是,这行日志是正常的。我由重新创建了一个springboot项目,在请求成功的情况下发现控制台也会打印这三行日志。

误区2:

        误区2是建立在误区1以上的,因为大家认为Initializing Spring DispatcherServlet是错误,所以去寻找相关的方法。其中有一个方法是配置文件中做如下修改。

但就经过我的观察,Initializing Spring DispatcherServlet在整个项目启动期间只打印一次,也就是说这个DispatcherServlet只初始化一次。(有点废话哈哈哈)以上这个配置是在项目启动的时候就初始化这个DispatcherServlet,如果不设置或者者设置为负数,那么就是等待第一次请求到来的时候初始化这个DispatcherServlet。大家可以自己试一试,看看是不是添加了上面的配置再启动项目,直接就会打印那三行日志,而不是等待请求到来的时候再打印。

问题解决:

        问题其实很简单,因为我们使用了@ComponentScan这个注解,在正常的springboot中是不需要使用这个注解的,所以application类会自动扫描自己所在的包和子包的所有文件。但是如果使用了这个注解,那默认的就失效了。这里使用@ComponentScan注解的原因可以五花八门,我是因为引入了一个自动建表的依赖,跟着教程做在application类上面添加了一个ComponentScan,所以解决方案就是将application类所在的包路径加进去就行。

 本质上还是对这些注解不够敏感,花了大量的事件做无用功,但好在解决了。

### Spring Boot 404 错误解决方案 当遇到 `Spring Boot` 中的 404 错误时,通常是因为请求路径未被正确映射到控制器方法或者项目的配置存在问题。以下是可能导致该问题的原因以及对应的解决办法: #### 可能原因及解决措施 1. **缺少 `@SpringBootApplication` 注解** 如果应用程序类上没有加上 `@SpringBootApplication` 注解,则可能无法扫描到组件或控制器类。因此需要确保主程序类上有此注解并将其放置在包结构的顶层位置[^1]。 2. **Controller 类定义不正确** 确认所有的 Controller 是否都标注了合适的注解(如 `@RestController`, `@Controller`),并且其内部的方法是否通过诸如 `@GetMapping`, `@PostMapping` 这样的 HTTP 方法映射进行了正确定义。 3. **Maven 或 Gradle 的依赖缺失** 若项目中涉及 Web 功能却遗漏了必要的 Starter 依赖项,比如 `spring-boot-starter-web`,则会引发资源不可访问的情况。对于标准 RESTful API 开发而言,应该引入如下依赖: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> ``` 4. **静态文件路径设置不当** 默认情况下,Spring Boot 将公共资源存放在 `/src/main/resources/static/` 下面;如果自定义了其他目录而忘记调整配置也可能造成页面找不到的现象。可以检查 application.properties 文件中的 spring.resources.static-locations 属性是否有修改过,并验证实际存储地址是否匹配。 5. **集成第三方技术时忽略额外配置** 当扩展功能至像 WebSocket 这样更复杂的领域时,除了基本框架之外还需要增加特定的支持库。例如,在实现基于消息推送的服务之前需添加 websocket starter 并完成相应 Bean 初始化工作[^2]: ```java import org.springframework.context.annotation.Bean; import org.springframework.web.socket.server.standard.ServerEndpointExporter; @Configuration public class WebSocketConfig { @Bean public ServerEndpointExporter serverEndpointExporter() { return new ServerEndpointExporter(); } } ``` 6. **URL 路径拼写错误** 检查浏览器输入 URL 和服务器端处理逻辑之间是否存在大小写差异或其他字符不符之处。 7. **嵌入式 Tomcat 配置冲突** 假设手动设置了 Servlet 容器参数但与默认行为相悖的话也容易触发异常状态码返回现象。此时建议查看文档重新评估相关选项设定值合理性。 综上所述,针对上述每种可能性逐一排查即可定位具体根源所在进而采取针对性修正动作来消除此类状况的发生几率。 ```java // 示例代码片段展示如何创建简单的 Rest 控制器 @RestController @RequestMapping("/api/v1/example") public class ExampleController { @GetMapping("/{id}") public String getExample(@PathVariable Long id){ return "You requested example with ID:" + id ; } } ```
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值