springmvc前台访问404，不能进入controller，后台不报错问题解决方案心得

      这是我第一次写博客，目的很明确，为了帮助像我一样的springmvc初学者解决一些问题，还有就时对自己返的错误的一个总结。

      从文章标题不难看出，是使用springmvc时出现了404错误，这里对具体的环境做一个描述。

      环境：

      1、项目开发环境为linux，开发工具eclipse。

      2、项目使用maven构建的web工程，框架搭建为spring+springmvc+mybatis。

      问题具体描述：

      从标题不难看出，框架搭建号后，编译部署并启动项目一切正常，并没有报任何的错误，但是从页面访问controller时缺报404[Not Found]的错误。

      解决方案：

      1、在这需要说明的是，由于后台从始至终没有报任何的错误，故我的文章里不会有出错的贴图，有人就会说了，为什么不把自己的配置文件贴给大家看呢，我认为没有必要，  因为接下来我会给大家讲解排错方法，并且贴上已经访问成功的完整代码贴图。其实刚开始一遇见这样的错误，自己也排查了一边没有任何的发现，于是就网上百度各种搜索，其中也搜到一些结果，按照提示操作一通都没有成功。这里我总结一下网上各种帖子的解决方案：

            1、大量文章都是千篇一律的说处理器映射器和处理器适配器以及视图解析器没有配置好，于是教你怎么去配置处理器映射器，这里我总结一个处理器映射器和适配器以及视图解析器的配置

                  1.1、非注解的处理器映射器和适配器配置，注意：在这里处理器映射器的配置必须和处理器适配器的配置是成对的，还有必须在配置文件里声明注入你的controller，并且这个controller必须实现Controller接口。非注解的配置访问是根据声明注入的bean name来进行映射处理的，必须有name,而且name的值必须有根符号（“/”）。

                  

                 1.2、注解的处理器映射器和适配器配置。注解的controller类必须使用@Controller进行注解，类中的方法使用@RequestMapping("")进行注解。注解的配置方式还有一种，即注解驱动配置，这样更方便，实际项目也是这样使用的。

                 1.3、视图解析器的配置。

            

                 至此，springmvc的controller需要的处理器映射器和处理器适配器以及视图解析器的配置已经完成，当然实际要运行的时候还必须要有Controller包扫描，不然你的程序在实例化完sqlSessionFactory后会一直卡在那里，不做任何操作，页面也不会有任何的反映。

      2、这网上的第二种解决方法说的最多的就是我上面说的Controller的包扫描没有加或者包扫描的配置是错误的，这如果说其他配置都OK的话，如果没有加包扫描，那么他不回报任何的错误，但是会输出日志，创建SqlSessionFactory的日志是有的，不会什么信息都没有。有的人将Controller的包扫描加成这样

也是什么都没有的。正确的包扫描是这样的：

      3、当然也有说jar包没有，这也有可能是有的，没有jar包报404很正常的。这里要说的是如果出现404，你的判断是jar包没有，那你就得去你的项目发布路径下的WEB-INF下的lib文件夹去找jar包，而不是你的eclipse里看有没有。更需要注意的是，有人在tomcat运行设置过发布路径，那就必须在你设置的发布路径下找，我的设置为tomcat的安装目录下的webapps下了。

      4、其实忘了一个最多的说法，那就是说你的请求地址是错误的，这个只能说自己认真排查，一般人在出现404的时候第一反应就是请求地址的核对，所以这个我也不说了。但是在这里我强调一个现象，就是你的请求地址是正确的，但是你的目录里没有Controller里的方法返回的页面，这样也会出现404,但是这个404和之前的404是不一样的。比如我在我的testController的items映射的方法里返回的itemsLists,实际我的jsp下的JSP文件没有一个itemsLists.jsp，那么页面的错误就会是这样的：

            

      5、还有一种解决办法说web.xml配置DispatcherServlet的时候servlet的映射关系配置不正确，应该将/*改为/*，去掉根号后面的星号，当然如果确实这样写了，那这也是一种解决办法。

      以上就是网上所说的解决这一问题的办法，其实也是我遇到这样的问题，在网上一通乱搜，挨个试了个遍。那么网上这么多的解决方法，我们到底应该去按哪个方法执行，像我一样挨个试一遍？就跟我一样，全部试完也不见得能解决你的问题，因为每个人的问题发生的原因都不一样，但是结果都一样，访问Controller失败，返回404。这也就是我写这篇文章的真正原因，我在这里不会贴出我解决该问题的代码，没有用对你，也许你的问题按照我的方法解决不了。那么我在这里将这个问题的解决思路抽取出来，这样大家就不用在网上搜各种解决方案还不一定适合你，只要按着这个思路找问题的根源，就不会有多大的问题。

      解决方案思路：

      1、分析问题原因

            我们既然知道是404，那就肯定是路径的问题，至少在现有的开发环境中大多数404都是各种路径的问题，不管是没有对应的文件还是路径写错了。既然404是路径问题，那么我们再细化这个路径问题，把这个路径可以分为前台访问路径和后台映射路径。

           1.1、前台访问路径：前台访问路径不用说就是我们在地址栏输入的路径，即http请求路径。

           1.2、后台映射路径：那么后台映射路径就多了，分析这个问题其实也很简单，既然是映射路径，那么他是怎么映射的，从哪里映射的，映射到哪里去，完成这三个问题也就解决了这个问题了。

                    1.2.1、在哪里映射、映射到哪里去：其中从哪里映射和映射到那里去，这个问题很好回答，既然是springmvc，那么这个问题肯定在Controller里了，当然这里的映射到那里去也要根据你自己配置视图解析器的规则去写。

                    1.2.2、怎么映射：然后我们分析这个路径是怎么映射的，这里就有人说了，一个刚学的就去研究spring源码吗？其实我们一般情况下没必要去翻源码查看他的实现原理，但是你如果有能力看他的源码，会加深你对springmvc的理解，对你也是有益无害的。虽然说我们没有必要翻源码但是必须知道他的映射关系是怎么配置的，弄清楚这些，我相信你的问题也就解决了。

       2、解决问题步骤

             我们已经把这个问题细化了，那么就一步步来解决就行了，在这里我会穿插的将我的完整代码贴出来，大家可以参考，初学者直接拿去也是可以运行的。在这里我先把我的工程目录给大家放在这里。

             2.1、前台访问路径：这个没有什么，只能是仔细的比对的你的请求路径是否正确，从项目工程名到到映射的方法名，再到返回的jsp名称。

            

             2.2、从哪里映射，映射到哪里去：这个问题我们就考虑Controller类中映射是不是不正确，查看@RequestMapping("/映射地址")中的映射地址是否与访问地址对应。

返回路径是否正确，例如返回consigner，在视图解析器配置的路径规则下能不能找到consigner.jsp文件。

            

                      

               2.3、这里是重点，看他是怎么映射的。我们知道springmvc是有前端控制器来调配映射器和适配器去工作的，那么我们首先要确保前端控制器配置正确。前端控制器配置好了，还需要处理器映射器和适配器以及视图解析器都配置好才可以。那么我们就得一个一个得排查这些所谓的各种器都配置好了吗？我把我的配置贴出来给大家参考。

               映射器、适配器和视图解析器：spring-mvc.xml

    
   
     
    
   
   
   
   
   
   
     
    
    
    
   
           
        
            
                text/html;charset=UTF-8
            
        
    
    
   
     

                 前端控制器配置：web.xml

	ssm-logistics
	ssm-logistics.root

   
      
        contextConfigLocation  
        classpath:conf/spring.xml;classpath:conf/spring-mybatis.xml  
    
    
    
        
        log4jConfigLocation
        classpath:conf/log4j.properties
    
    
        
        log4jRefreshInterval
        6000
    
    
        org.springframework.web.util.Log4jConfigListener
     
    
      
        org.springframework.web.context.ContextLoaderListener  
      
      
      
        org.springframework.web.util.IntrospectorCleanupListener  
      
  
      
    
	
		springMVC
		org.springframework.web.servlet.DispatcherServlet
		
			contextConfigLocation
			classpath:conf/spring-mvc.xml
		
		2
	
	
		springMVC
		/
	

	
		index.jsp
	

	
	
		
		404
		/WEB-INF/errorpage/404.jsp
	
	
		
		405
		/WEB-INF/errorpage/405.jsp
	
	
		
		500
		/WEB-INF/errorpage/500.jsp
	  
      
      
      
        encodingFilter  
        org.springframework.web.filter.CharacterEncodingFilter  
          
            encoding  
            UTF-8  
          
          
            forceEncoding  
            true  
          
      
      
        encodingFilter  
        /*  
    

           2.4、如果说前面这些都配置好了，问题还是存在，我们就得去查看配置的这些器都起作用了没有，即这些配置文件有没有一步步的都加载到spring容器中。那么我们要在web.xml里面加载那些东西呢？因为我是SSM框架，所以spring的配置文件，springmvc的配置文件，mybatis的配置文件，mysql数据库的配置文件，spring和mybatis整合的配置文件等都要加载到spring容器中。当然每个人写配置文件的方式不一样，加载的方式也不一样，但是都有一定的约定必须遵循。我是这样加载的：大家可以看的web.xml配置文件，我在这里面加载了spring配置文件和springmvc的配置文件以及spring和mybatis整合的配置文件。现在将另外两个配置文件贴出来：

           spring.xml

           spring这里我引入了jdbc的配置文件，还加了service包的自动扫描，将service层注入到容器中

           spring-mybatis.xml

           这里我设置了连接池和事务管理，引入了mybatis的配置文件，加了mapper.xml及dao文件的自动扫描注入

    
    
      ${jdbc_driverClassName}
    
    
      ${jdbc_url}
    
    
      ${jdbc_username}
    
    
      ${jdbc_password}
    
    
    
      20
    
    
    
      1
    
    
    
      60000
    
    
    
      20
    
    
    
      3
    
    
    
      true
    
    
    
      180
    
    
    
      clientEncoding=UTF-8
    
  
    
    
      
      
   
 
 
   
  

         2.5、如果以上都配置好了，还是不成功，那么就得在看看这些自动化的东西到底有没有自动化成功，例如service的自动扫描有没有起作用，Controller的自动扫描有没有起作用或者说是配置正确不正确。我的Controller的自动扫描是在spring.xml文件完成的。

         2.6、如果说controller配置没有错误，那就看看是不是jar包的问题，记得在工程发布的路径下查看。

         2.7、如果说还不成功，那就只能继续深入看源码了。还有一个方法就是启动的时候使用DEBUG模式，且在发布时去掉autoloading enabled，这样如果是源码问题就会卡出来，可以看到提示。不过相信走到这一步基本也就把错误排查出来了，一般不会去看源码提示，因为除非导包的问题，源码不会有错。

        至此我将我的思路和错误排除的方法告诉大家，希望可以帮助到一些人。这篇文章是一个错误处理的排查思路分析及解决的文档，不是教大家怎么构建工程的文档，所以文件不是很全，但是配置文件都是没有问题的，只要更改目录和名称就可以只在项目中使用了。有什么问题希望留言大家共同探讨。我将其他的文件贴出来，以便大家可以直接复制去调试。

       附件：

       1、jdbc.properties

       

jdbc_driverClassName=com.mysql.jdbc.Driver
jdbc_url=jdbc:mysql://localhost:3306/SSYS_LOGISTICS?useUnicode=true&characterEncoding=utf-8
jdbc_username=root
jdbc_password=root

       2、log4j.properties

 ### set log levels ###
#log4j.rootLogger = debug , stdout , D , E
log4j.rootLogger = debug , stdout , D

###  output to the console ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
#log4j.appender.stdout.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n
log4j.appender.stdout.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n

### Output to the log file ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = /home/workspace/logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

### Save exception information to separate file ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = /home/workspace/logs/error.log 
log4j.appender.D.Append = true
log4j.appender.D.Threshold = ERROR 
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n

       3、mybatis-cofig.xml

好了在这里说下我的错误吧，我是在复制web.xml配置文件的时候，没有将mybatis和spring的整合文件加载进来，所以大多数的错误都是人为的，而且是不起眼的小问题，可就是这些不起眼的小问题，总是折腾人。我们还是要认真排查每一行代码，认真对待每一件事。事无大小事，人无贵贱人！哈哈！