【noHandlerFound(DispatcherServlet.java:1278)和No mapping for GET】SpringMVC 404和中文乱码问题和解决方案记录

超、凢脫俗 2023-10-02 18:47 3阅读 0赞

#### 文章目录 ####

*  前言
 *  demo项目概述
 *   *  项目结构
     *  tomcat服务器配置
     *  相关java代码
     *  相关配置文件
 *  出现的问题
 *   *  404问题
     *  404问题尝试解决方案
     *   *  配置默认映射(失败)
         *  配置jsp映射(成功)
         *  springmvc配置\`<mvc:default-servlet-handler/>\`标签(成功)
         *   *  注意
     *  乱码问题
     *   *  解决过程
 *  总结

## 前言 ##

刚开始学习`springmvc`，却被`404`和`乱码`搞得晕头转向,为此还没学多少`springmvc`的其他知识，就开始调试它的源码查找问题了,还花了一天的时间，这里先记录一下。**如有错误，可以指出。**

## demo项目概述 ##

### 项目结构 ###

![picture 2][]

### tomcat服务器配置 ###

![picture 3][]

### 相关java代码 ###

package com.wcj.springmvc.controller;
    
    import org.springframework.web.servlet.ModelAndView;
    import org.springframework.web.servlet.mvc.Controller;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    /**
     * @description: UserController
     * @date: *****
     * @author: ******
     */
    public class UserController implements Controller {
        
    
        @Override
        public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        
            return new ModelAndView("/WEB-INF/templates/index.html");
        }
    }

### 相关配置文件 ###

*  **springmvc-servlet.xml**

<?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
        
        <bean name="/" class="com.wcj.springmvc.controller.UserController"/>
    
    </beans>

*  **web.xml**

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
             version="4.0">
    
        <filter>
            <filter-name>characterEncodingFilter</filter-name>
            <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
            
            <init-param>
                <param-name>encoding</param-name>
                <param-value>UTF-8</param-value>
            </init-param>
            
            <init-param>
                <param-name>forceEncoding</param-name>
                <param-value>true</param-value>
            </init-param>
        </filter>
    
        <filter-mapping>
            <filter-name>characterEncodingFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>
    
        <servlet>
            <servlet-name>dispatcherServlet</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            <init-param>
                <param-name>contextConfigLocation</param-name>
                <param-value>classpath:springmvc-servlet.xml</param-value>
            </init-param>
            <load-on-startup>1</load-on-startup>
        </servlet>
    
        <servlet-mapping>
            <servlet-name>dispatcherServlet</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>
    
    
        <listener>
            <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
        </listener>
    
        <context-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring-context.xml</param-value>
        </context-param>
    
    
    </web-app>

## 出现的问题 ##

### 404问题 ###

按上述配置后访问会出现404问题

![picture 1][]  
控制台输出

[WARN ] org.springframework.web.servlet.DispatcherServlet.noHandlerFound(DispatcherServlet.java:1278) - No mapping for GET /my_springmvc/WEB-INF/templates/index.html

由于刚刚学习，对于springmvc的处理机制还没熟悉，  
不确定是否按下面的方式返回`ModelAndView`对象是否正确

return new ModelAndView("/WEB-INF/templates/index.html");

于是，我尝试了将`index.html`改为`index.jsp`，在`/WEB-INF/templates`目录下新建一个index.jsp，发现访问正常，这个可以说明这样配置是可以访问的

> 其实是因为我们访问`/`这个路径会被配置为`<url-pattern>/</url-pattern>`的`dispatcherServlet`处理，`dispatcherServlet`会调用我们配置了路径为`/`的处理方法，即`UserController`。`springmvc`获取`ModelAndView`,将请求转发到能处理`/WEB-INF/templates/index.jsp`的`servlet`上，这个请求实际上会转发给`tomcat`处理`jsp`的`servlet`，所以可以正确响应

![picture 4][]

### 404问题尝试解决方案 ###

> 如果对tomcat的路径匹配感兴趣可以看一下我之前写的  
> [搞懂tomcat中web.xml配置servlet的url-pattern为"/“和”/\*"的区别][tomcat_web.xml_servlet_url-pattern]

#### 配置默认映射(失败) ####

--------------------

我在网上查了一下,发现有些是说配置如下映射可以解决html访问的问题

<servlet-mapping>
            <servlet-name>default</servlet-name>
            <url-pattern>*.html</url-pattern>
    </servlet-mapping>

然而这个配置并没有生效，这个配置看似可以匹配`/WEB-INF/templates/index.html`这个路径。但是，我们一开始访问的路径是`/`，而且这个并**不会**匹配到配置为`<url-pattern>/</url-pattern>`的`dispatcherServlet`,而是匹配到`tomcat`默认的`DefaultServlet`,这个和tomcat的路径匹配规则有关，因为我们配置了上面的`*.html`拓展名映射，这个就会导致`/`匹配到了`DefaultServlet`，它实际会访问`/index.html`，但是我并没有在根目录下放置`index.html`这个文件，所以会出现`404`的问题。

看来这个配置只是解决访问根目录下的`index.html`的问题。但是，我要访问的是在`/WEB-INF/templates/index.html`这个路径下的

#### 配置jsp映射(成功) ####

--------------------

接着，我又看到一个配置

<servlet-mapping>
            <servlet-name>jsp</servlet-name>
            <url-pattern>*.html</url-pattern>
        </servlet-mapping>

![picture 5][]

将`html`拓展名的请求交给处理`jsp`的`servlet`,显然，这个是可以的，这个就和处理`jsp`的情况一样了，不过这样把`html`的请求交给处理`jsp`的，感觉怪怪的

#### springmvc配置`<mvc:default-servlet-handler/>`标签(成功) ####

--------------------

所以再接着，我看到一个说在`springmvc`的配置文件中加入`<mvc:default-servlet-handler/>`，这个配置后也是可以正确访问到的

> 这个配置会在`springmvc`的上下文中定义一个`DefaultServletHttpRequestHandler`,这个会在没有其他更具体的映射（即到控制器）可以匹配时会执行，这个程序会转发请求到默认Servlet

--------------------

##### 注意 #####

> 默认情况下，springmvc会默认读取`DispatcherServlet.properties`文件列举的`HandlerMapping`  
> ![picture 3][picture 3 1]  
> ![picture 1][picture 1 1]  
> ![picture 2][picture 2 1]  
> 但是配置了`<mvc:default-servlet-handler/>`会导致默认配置失效，但是这个配置也会自动注册一些`HandlerMapping`；除了会注册`DefaultServletHttpRequestHandler` 还将注册一个`SimpleUrlHandlerMapping`用于映射资源请求，以及一个`HttpRequestHandlerAdapter` ,此外还会注册如下组件  
> ![picture 4][picture 4 1]  
> 所以如果只配置`<mvc:default-servlet-handler/>`，则只会有`SimpleUrlHandlerMapping`和`BeanNameUrlHandlerMapping`这两个`HandlerMapping`，没有`RequestMappingHandlerMapping`,会导致使用`@RequestMapping`之类注解的配置失效，无法映射。
> 
>  *  解决这个问题可以在`springmvc`配置文件中配置`<mvc:annotation-driven/>`，这个会自动注入`RequestMappingHandlerMapping`和`BeanNameUrlHandlerMapping`
>     
>     ![picture 5][picture 5 1]  
>     当然我们也可以手动注册
> 
>     <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
>            <property name="order" value="0"/>
>     </bean>
>     <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>

### 乱码问题 ###

在处理完404问题后，还有一个初学者经常见到的问题，那就是中文乱码了

*  `index.html`文件内容

![picture 7][]

*  浏览器结果

![picture 6][]

*  响应头

![picture 14][]

我使用的是idea编辑器，我设置了文件编码都是`utf-8`

![图片1][1]

#### 解决过程 ####

在web项目中出现了乱码，一般可以通过过滤器来解决，springmvc中提供了一个处理编码得过滤器`CharacterEncodingFilter`  
,在web.xml中配置如下过滤器即可

<filter>
            <filter-name>characterEncodingFilter</filter-name>
            <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
            
            <init-param>
                <param-name>encoding</param-name>
                <param-value>UTF-8</param-value>
            </init-param>
            
            <init-param>
                <param-name>forceEncoding</param-name>
                <param-value>true</param-value>
            </init-param>
        </filter>
    
        <filter-mapping>
            <filter-name>characterEncodingFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>

然而这个配置并没有解决`index.html`中文乱码得问题，而且，我一开始就配置了这个过滤器的。但是，这个配置确实是设置了编码的了，不过为什么没作用呢？

在java中我知道的可以影响编码的属性有`encoding`和`file.encoding`，于是我想到打印一下`file.encoding`属性的值是否是utf-8

![picture 8][]

输出如下

![picture 9][]

发现他的值是`GBK`，于是我在`vm options`中加入  
`-Dfile.encoding=utf-8`，重启服务器

![picture 10][]

最后发现，乱码问题解决

> `file.encoding`在这里影响的是什么呢?，既然`response`已经设置编码为`utf-8`，那么说明这个响应到浏览器的编码是没有问题的，还有一个就是读取本地的`index.html`文件时所使用的编码，如果以`GBK`读取`index.html`文件，再以`UTF-8`响应文件给浏览器，那么就会出现问题了，可见这个`file.encoding`在这里影响的是读取本地文件的编码

![picture 11][]

> 浏览器可能会缓存，导致页面没有变化，可以禁用缓存，多刷新几次  
> ![picture 12][]

## 总结 ##

遇到问题，我们除了利用好搜索引擎，合理debug查找问题也是一种锻炼，这样可以更好理解代码的流程，提高自己的调式和排错能力

[picture 2]: https://img-blog.csdnimg.cn/img_convert/f3089f32039a7687399769a09ad2db49.png
[picture 3]: https://img-blog.csdnimg.cn/img_convert/ff4a93d9133aef9376bebbd6688ff66c.png
[picture 1]: https://img-blog.csdnimg.cn/img_convert/f444133449d127a3091975e1645ffb98.png
[picture 4]: https://img-blog.csdnimg.cn/img_convert/22aeb733e54bf8cd95a0562b76baf6e6.png
[tomcat_web.xml_servlet_url-pattern]: https://blog.csdn.net/m0_52440465/article/details/122766656
[picture 5]: https://img-blog.csdnimg.cn/img_convert/e2e47f48a639f8989ab0000e3eace943.png
[picture 3 1]: https://img-blog.csdnimg.cn/img_convert/a479de2b9bdc6d6b276fdc1966795104.png
[picture 1 1]: https://img-blog.csdnimg.cn/img_convert/3bd53a3faa1ae928ec5234c067eeafaa.png
[picture 2 1]: https://img-blog.csdnimg.cn/img_convert/581994e3362987b967b689fc8e198247.png
[picture 4 1]: https://img-blog.csdnimg.cn/img_convert/bf31ecb04d6a348f1bab8027159d924b.png
[picture 5 1]: https://img-blog.csdnimg.cn/img_convert/67cc3019f3d3eb435c2062182b7fbaf8.png
[picture 7]: https://img-blog.csdnimg.cn/img_convert/787dbd06e566198027337aa1e72a8825.png
[picture 6]: https://img-blog.csdnimg.cn/img_convert/b4c7fdffa4fe9c60eb9ca2d7c51e4c48.png
[picture 14]: https://img-blog.csdnimg.cn/img_convert/e094a6a0830b0ddbf8a058d994eaa5f9.png
[1]: https://img-blog.csdnimg.cn/img_convert/d5cd5d3ebb6b827fbf5bd590e7a2a236.png
[picture 8]: https://img-blog.csdnimg.cn/img_convert/5c33729e9936d1faf45ebb7adccc83c0.png
[picture 9]: https://img-blog.csdnimg.cn/img_convert/bdb00abe44025fda4db797b595501634.png
[picture 10]: https://img-blog.csdnimg.cn/img_convert/094114a67070f35fd1207611d45eacc9.png
[picture 11]: https://img-blog.csdnimg.cn/img_convert/06acdf196930fb998184d673a3131969.png
[picture 12]: https://img-blog.csdnimg.cn/img_convert/e534a2ce393860ce8e4118f0dae6796a.png