18个 SpringBoot项目中遇到的BUG，你试试

640?wx_fmt=gif

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTcwNjU4,size_16,color_FFFFFF,t_70

有人说：一个人从1岁活到80岁很平凡，但如果从80岁倒着活，那么一半以上的人都可能不凡。

生活没有捷径，我们踩过的坑都成为了生活的经验，这些经验越早知道，你要走的弯路就会越少。

1.启动项目的时候报错

1.Error starting ApplicationContext. 
To display the auto-configuration report re-run your application with 'debug' enabled.

解决方法：

在yml配置文件中加入debug: true,因为默认的话是false

2.在集成mybatis时mapper包中的类没被扫描

org.springframework.beans.factory.NoSuchBeanDefinitionException:
 No qualifying bean of type 'com.app.mapper.UserMapper' available: 
expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}

解决方法：

在springboot的启动类中加入@MapperScan("mapper类的路径")
或者直接在Mapper类上面添加注解@Mapper,建议使用上面那种，不然每个mapper加个注解也挺麻烦的

3.在向数据库插入数据时报错

"\r\n### Error updating database.  Cause: 
com.mysql.jdbc.MysqlDataTruncation: 
Data truncation: Data too long for column 'password' at row 1\r\n###

数据库表password这个字段太短了，应该设长点

java.lang.ClassCastException: 
com.app.entity.User cannot be cast to java.lang.Integer

4.用mybatis查询时报错

org.mybatis.spring.MyBatisSystemException: 
nested exception is org.apache.ibatis.binding.BindingException: 
Parameter 'user_type' not found. Available parameters are [2, 1, 0, param1, param2, param3]

原因：@Param注解缺失，当只有一个参数时，Mapper接口中可以不使用

public User getUser(String name);

有多个参数时就必须使用

public User getUser(@Param("name") String name,@Param("password") String password);

5.Mybatis查询传入一个字符串传参数报错

mapper接口：
PkRecord findByPkStudentNumber(String pkStudentNumber);
对应的mapper配置文件
<select id="findByPkStudentNumber" resultMap="recordMap" >
        SELECT * FROM pk_record
        <where>
            <if test="pkStudentNumber!=null">
                pk_student_number=#{pkStudentNumber}
            </if>
        </where>
    </select>

然后就会报如下错误

There is no getter for property named 'XXX' in 'class java.lang.String'

原因：

Mybatis默认采用ONGL解析参数，所以会自动采用对象树的形式取string.num值，引起报错。

解决方法：

①在mapper配置文件中参数名，都要改成_parameter

<select id="findByPkStudentNumber" resultMap="recordMap" >
        SELECT * FROM pk_record
        <where>
            <if test="_parameter!=null">
                pk_student_number=#{_parameter}
            </if>
        </where>
    </select>

②在mapper接口中用@Param在相关方法说明参数值

PkRecord findByPkStudentNumber(@Param("pkStudentNumber") String pkStudentNumber);

6.mybatis返回值报错

org.apache.ibatis.binding.BindingException: 
Mapper method 'com.hoomsun.mybatis.dao.CostMapperDao.dongtaislq' 
has an unsupported return type: class java.lang.String

dao接口类中对应的方法去掉返回值，用void，例如：

public void dongtaislq(Map map);

7.mybatis中集合与Stirng类型的比较

报错信息

invalid comparison: java.util.ArrayList and java.lang.String

原因：无法比较这两种类型

<if test="categoryIds!=null and categoryIds!=' ' ">
        AND category_id IN
        <foreach collection="categoryIds" item="categoryIds" open="(" separator="," close=")">
            #{categoryIds}
        </foreach>
</if>

在接收list的时候加了判断 list !=' '，引起了集合与Stirng类型的比较，所以报错，将判断条件改为： list.size >0就可以了

<if test="categoryIds!=null and categoryIds.size>0" >
        AND category_id IN
        <foreach collection="categoryIds" item="categoryIds" open="(" separator="," close=")">
            #{categoryIds}
        </foreach>
</if>

8.保存对象数据进数据库后根据ID查询并返回该对象时为null

<insert id="saveUser" useGeneratedKeys="true" keyColumn="id" >
        insert into user(username,password,nickname) values (#{username},#{password},#{nickname})
</insert>

这样写的话数据可以保存到数据库,没问题,ID也可以自动增长，不过保存后立刻根据ID查询时返回会为null
解决的方法是把keyColumn换成keyProperty就可以了

<insert id="saveUser" useGeneratedKeys="true" keyProperty="id" >
        insert into user(username,password,nickname) values (#{username},#{password},#{nickname})
</insert>

9.idea运行项目时报错

//子容器启动失败
ERROR 8760 --- [cat-startStop-1] org.apache.catalina.core.ContainerBase   : A child container failed during start
//未能启动Tomcat组件
java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException: 
Failed to start component [StandardEngine[Tomcat].StandardHost[localhost].TomcatEmbeddedContext[]]

这里的问题主要是jre环境没选好，可能是由于你之前项目要求改变jre，然后导致之前的项目jre环境也改变了。

idea具有内置tomcat，所以可以不用额外配置tomcat

在idea中点击运行→编辑结构→在配置中选择jre环境

我这里是选用1.8的环境

Paste_Image.png

再次启动项目：

Paste_Image.png

启动成功了

10.mybatis插入数据时默认值不生效

插入语句

<insert id="insert" useGeneratedKeys="true" keyProperty="id">
    insert into mmall_category (id, name, status)
    values (#{id}, #{name},#{status})
  </insert>

对应的mapper

void insert(Category category);

需要传入的是一个对象，假如你在数据库设计时把status设置默认值
在传入对象时只赋值给name，结果你可以发现数据库中status的值是null

这是因为这个对象的其他属性成员你不赋值的话默认为null，并且你在sql语句中#{status}，也就是把null赋给了status，但是有时候有需要传status，不能把#{status}去掉，那该怎么办呢？
解决方法：

<insert id="insert" useGeneratedKeys="true" keyProperty="id">
    insert into mmall_category 
      (id, name
        <if test="status != null">
            ,status
        </if>)
    values (#{id}, #{name}
        <if test="status != null">
            ,#{status}
        </if>)
  </insert>

使用mybatis的if test进行值的判断，如果是null的话就不赋值

mybatis的高级结果映射

association – 一个复杂的类型关联;许多结果将包成这种类型
嵌入结果映射 – 结果映射自身的关联,或者参考一个
看起来挺难懂的，看下实例
在resultMap中，有这样的一个映射

<association property="user" column="user_id" select="com.mapper.UserMapper.selectByPrimaryKey"/>

当你用select查询出来对象时想获取userId的值要先获取映射的对象再获取其ID，不然直接获取userId会为空

11.InterlliJ Debug方式启动特别慢

Method breakpoints may dramatically slow down debugging

不管你是重启服务器和重启idea还是报这个问题。由该提示语我们可以知道要把方法断点给关掉，查看断点的快捷方式是Ctrl + Shift +F8

image.png

把Java Method Breakpoints去掉即可

错误Caused by: java.lang.IllegalStateException: In the composition of all global method configuration, no annotation support was actually activated

原因：在所有全局方法配置的组合中，实际上没有激活注释支持

解决方法：

在启动类中加入@EnableGlobalMethodSecurity(securedEnabled = true)

@SpringBootApplication
@EnableGlobalMethodSecurity(securedEnabled = true)
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

12.MyBatis绑定错误

Invalid bound statement (not found)

这个错误主要是因为mapper接口与mapper.xml的路径没有一一对应,并且mapper.xml不能放在src目录里，配置文件必须放resources里，src目录下的xml文件默认不会编译到target。

13.使用请求转发或者重定向出现异常

java.lang.IllegalStateException: Cannot forward after response has been committed

原因：

报异常的原因是重复转发或者重定向了请求

解决方法：

如果有多个转发或者重定向，需要在每个转发或者重定向请求之后加上return语句(最后一个请求转发或者重定向可以不加)

14.SpringBoot配置数据库连接池，但日志却每次都新建连接

Mybatis中动态打印SQL语句到控制台,只需要在SpringBoot配置文件中添加如下配置即可

mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

但是如果没有用到任何连接池的话，是不会打印的

Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@2a5ca7d7] was not 
registered for synchronization because synchronization is not active
JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@9a51d74] will not be managed by Spring
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@2a5ca7d7]

解决方法：

确保有可用的连接池被使用，引入第三方连接池要做好配置

15.SpringBoot项目中service层互相引用

Description:
The dependencies of some of the beans in the application context form a cycle:
   xxxController (field private aaaService xxxController.aaaService)
┌─────┐
|  aaaImpl defined in file [aaaImpl.class]
↑     ↓
|  bbbImpl (field private aaaService bbbImpl.orderService)
└─────┘

解决方法：

注入方式用的是@RequiredArgsConstructor 注解final方式注入报错
将注入方式改为@Autowired成功解决

16.SpringBoot配置文件中使用了过时的配置项

Caused by: org.springframework.boot.context.properties.bind.UnboundConfigurationPropertiesException:
 The elements [spring.resources.chain.gzipped] were left unbound.

已废弃的配置项

spring:
  resources:
      chain:
        gzipped: true

解决方法：删掉过期的配置项即可

17.无法访问javax.servlet.Filter

解决方法：加上web依赖

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>