【解决】SSM框架整合常见报错及解决方法

1.版本号问题：

Spring整合Mybatis的时候，对依赖的版本号有严格的规定，如果版本号没有按照官网的标准，会报错org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping': Initialization of bean failed; nested exception is org.springframework.beans.factory.CannotLoadBeanClassException: Error loading class [org.mybatis.spring.SqlSessionFactoryBean] for bean with name 'sqlSessionFactory' defined in class path resource [spring-dao.xml]: problem with class file or dependent class; nested exception is java.lang.UnsupportedClassVersionError: org/mybatis/spring/SqlSessionFactoryBean has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

详情参考：http://mybatis.org/spring/

2.获取properties中数据源信息问题：

Spring管理数据源dataSource，如果利用读取properties的方式获取数据源信息，那么properties中数据源信息的格式必须是xxx.xxx，不能直接写driver、url、username、password，如：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/zyc?useUnicode=true&characterEncoding=utf8&useSSL=true&serverTimezone=UTC
jdbc.username=root
jdbc.password=123456

    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="password" value="${jdbc.password}"/>
        <property name="user" value="${jdbc.username}"/>
        <property name="driverClass" value="${jdbc.driver}"/>
        <property name="jdbcUrl" value="${jdbc.url}"/>

        <!--c3p0连接池私有属性-->
        <property name="maxPoolSize" value="30"/>
        <property name="minPoolSize" value="10"/>
        <!--关闭连接后不自动连接-->
        <property name="autoCommitOnClose" value="false"/>
        <!--获取连接超时时间，10秒-->
        <property name="checkoutTimeout" value="10000"/>
        <!--获取连接失败重试次数-->
        <property name="acquireRetryAttempts" value="2"/>
    </bean>

如果properties中数据源信息是xxx格式，会报错java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)

3.打包发布路径下没有添加依赖问题：

IDEA默认问题，在IDEA中查看Project Settings->Artifacts，查看WEB-INF下是否存在lib包，以及lib包下是否存在所有添加的依赖。没有的话需要新建lib包，然后将所有依赖添加进去。

如果 WEB-INF下不存在包含所有依赖的lib包，会导致后续访问页面时报404

4.DispatcherServlet关联配置文件问题：

在web.xml中配置的DispatcherServlet，关联配置文件，有时候因为惯性思维还在关联spring-mvc.xml，可能会导致后续访问页面时报500异常

SSM整合中直接关联applicationContext.xml即可，因为applicationContext.xml会整合、引入其他的spring配置文件

<servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--关联springMVC的配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:applicationContext.xml</param-value>
        </init-param>
        <!--服务器启动时创建核心处理器实例，启动级别为1-->
        <load-on-startup>1</load-on-startup>
    </servlet>

5.Jackson与Spring版本不兼容问题：

这个是最搞心态的一个问题，在SSM项目中使用Jackson，Sping使用的版本是5.3.2，Jackson使用的版本是2.8.7，报错java.lang.NoClassDefFoundError: com/fasterxml/jackson/core/JsonProcessingException，说明Jackson与Spring版本不兼容

试验完各版本，得出结论：

如果Spring版本是5.3.0+，推荐使用的Jackson版本2.10.0+

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.20</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.11.2</version>
        </dependency>

6.Spring配置中夹杂注释问题

如下所示：

如果Spring配置中夹杂着中文，可能会报错Failed to import bean definitions from URL location [classpath:spring-dao.xml]；BeanDefinitionStoreException: IOException parsing XML document from class path resource [applicationContext.xml]; nested exception is java.io.FileNotFoundException: class path resource [applicationContext.xml] cannot be opened because it does not exist

解决方法就是将配置文件头部的UTF-8改为UTF8

参考：Failed to import bean definitions from URL location [classpath:spring-dao.xml]_路窑的博客-CSDN博客