springboot:No mapping found for HTTP request with URI [/.html] in DispatcherServlet with name 'dispatcherServlet'
时间: 2025-06-23 11:25:31 浏览: 11
### 解决 Spring Boot 中 DispatcherServlet 找不到映射到 HTTP 请求 URI `/.html` 的问题
当遇到 DispatcherServlet 报告找不到映射到特定 URL 如 `/example.html` 或根路径下的 `.html` 文件时,通常是因为应用程序配置未能正确处理静态资源或视图解析。
#### 配置静态资源位置
默认情况下,Spring Boot 支持从多个预定义的位置加载静态文件,包括但不限于 `classpath:/static/`, `classpath:/public/`, `classpath:/resources/`, 和 `classpath:/META-INF/resources/`. 如果 HTML 页面位于这些目录之外,则需调整配置以包含自定义路径[^1].
对于简单的HTML页面展示需求,建议将HTML文件放置于上述任一标准目录内。例如,在项目结构中的 `src/main/resources/static/index.html`.
#### 启用WebMvc自动配置
确认已启用 Web MVC 自动配置功能。如果手动排除了该组件,可能需要重新引入它来确保基本的MVC特性正常工作:
```java
@SpringBootApplication(exclude={org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration.class})
// 应移除此行或取消exclude参数设置
```
#### 设置ViewResolver Bean (可选)
为了支持JSP或其他模板引擎渲染动态内容,可以通过创建一个内部资源视图解析器bean实现更灵活的内容呈现方式:
```java
@Bean
public InternalResourceViewResolver defaultViewResolver() {
return new InternalResourceViewResolver();
}
```
然而针对纯静态网页访问场景,默认行为已经足够满足需求,无需额外定制view resolver.
#### 检查控制器方法签名
确保所有的@RequestMapping注解都指定了具体的方法类型(GET, POST等),并验证URL模式是否匹配实际请求地址。比如下面的例子适用于GET类型的根路径(`"/"`)请求返回index.html文档:
```java
@Controller
public class HomeController {
@GetMapping("/")
public String home(){
return "forward:index.html";
}
}
```
通过以上措施应该能够有效解决DispatcherServlet无法找到对应URI的问题。同时注意检查日志输出寻找更多线索帮助定位潜在错误源。
阅读全文
相关推荐
















(一)项目构建
使用 Maven 构建项目,在pom.xml中引入 Spring MVC 相关依赖,如spring - webmvc,配置 Servlet、JSP 等相关依赖,确保项目具备 Spring MVC 运行环境 。示例关键依赖配置:
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring - webmvc</artifactId>
<version>5.3.18</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet - api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp - api</artifactId>
<version>2.3.3</version>
<scope>provided</scope>
</dependency>
</dependencies>
(二)Spring MVC 配置
DispatcherServlet 配置:在 Web.xml(或 Servlet 3.0 + 环境下用 Java 配置)中配置 DispatcherServlet,指定 Spring MVC 配置文件位置,使其能拦截处理请求 。示例 Web.xml 配置:
<servlet>
<servlet - name>springmvc</servlet - name>
<servlet - class>org.springframework.web.servlet.DispatcherServlet</servlet - class>
<init - param>
contextConfigLocation
classpath:springmvc - servlet.xml
</init - param>
<load - on - startup>1</load - on - startup>
</servlet>
<servlet - mapping>
<servlet - name>springmvc</servlet - name>
<url - pattern>/</url - pattern>
</servlet - mapping>
Spring MVC 配置文件(springmvc - servlet.xml):开启组件扫描(扫描控制器等组件)、视图解析器(配置前缀后缀,解析 JSP 视图)、开启注解驱动等 。示例:
<context:component - scan base - package="com.example.controller"/>
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
</bean>
<mvc:annotation - driven/>
三)功能模块实现
1. 用户登录验证
o 控制器(Controller):创建LoginController,编写方法处理/login请求(对应login.jsp表单提交),接收用户名、密码参数(可通过@RequestParam注解),进行简单验证(如硬编码用户名 “admin”、密码 “123” 模拟,实际可连数据库查询),验证成功用return "redirect:/main";重定向到主页控制器方法,失败则带错误信息(通过model.addAttribute)返回login视图(即login.jsp )。示例代码:
package com.example.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
@Controller
public class LoginController {
@RequestMapping("/login")
public String login(@RequestParam("username") String username,
@RequestParam("password") String password,
Model model) {
if ("admin".equals(username) && "123".equals(password)) {
return "redirect:/main";
} else {
model.addAttribute("error", "用户名或密码错误");
return "login";
}
}
2. 登录页面(login.jsp):使用 Spring 表单标签库(需引入相关标签库)或普通 HTML 表单,提交到/login,显示错误信息(通过 EL 表达式${error} )。示例关键代码:
<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form" %>
<html>
<body>
<form:form action="/https/wenku.csdn.net/login" method="post">
用户名:<form:input path="username"/>
密码:<form:password path="password"/>
<input type="submit" value="登录">
</form:form>
<c:if test="${not empty error}">
${error}
</c:if>
</body>
</html>
3. 访问控制(拦截器实现)
o 创建拦截器类:实现HandlerInterceptor接口,在preHandle方法中检查会话是否有用户登录标识(如session.getAttribute("user") ,假设登录成功时在会话存user对象),无则redirect到/login并返回false拦截,有则返回true放行 。示例:
package com.example.interceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.servlet.HandlerInterceptor;
public class LoginInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request,
HttpServletResponse response,
Object handler) throws Exception {
Object user = request.getSession().getAttribute("user");
if (user == null) {
response.sendRedirect(request.getContextPath() + "/login");
return false;
}
return true;
}
}
4. 配置拦截器:在 Spring MVC 配置文件(springmvc - servlet.xml)中注册拦截器,指定拦截路径(如/main )。示例:
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/main"/>
<bean class="com.example.interceptor.LoginInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
5. 会话管理(登出功能)
o 控制器方法:在MainController中编写处理登出的方法,调用session.invalidate()销毁会话,然后redirect到登录页 。示例:
package com.example.controller;
import javax.servlet.http.HttpSession;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MainController {
@RequestMapping("/main")
public String main() {
return "main";
}
@RequestMapping("/logout")
public String logout(HttpSession session) {
session.invalidate();
return "redirect:/login";
}
}
6. 主页(main.jsp):添加 “退出” 链接, href 指向/logout 。示例:
<html>
<body>
欢迎访问主页
退出
</body>
</html>


