初学SpringBoot遇到的坑和笔记

目录

• 1.日期返回给前端显示不理想问题
  • 1.1重现
  • 1.2原因
  • 1.3解决
  • 1.4结果
• 2.MyBatis-Plus数据库字段未找到问题
  • 2.1重现
  • 2.2原因
  • 2.3解决
• 3.Long型雪花主键返回给前端精度丢失问题
  • 3.1重现
  • 3.2原因
  • 3.3解决
  • 3.4结果
• 4.Maven依赖下载过慢
  • 4.1原因
  • 4.2解决
• 5.实体对象某字段为空值返回给前端显示为null问题
  • 5.1重现
  • 5.2原因
  • 5.3解决
  • 5.4结果
• 6.Swagger2中全局参数的配置
  • 6.1问题
  • 6.2解决
  • 6.3结果
• 7.实体作为参数，但参数列表过长在Swagger2中需隐藏部分参数的问题
  • 7.1问题
  • 7.2解决
  • 7.3结果
• 8.参数为Date，前端不知道传啥格式
  • 8.1重现
  • 8.2解决

1.日期返回给前端显示不理想问题

1.1重现

不作配置返回的Date类型如下，格式不令人满意，时间也少了8个小时

{"Date": "2019-11-17T11:39:15.000+0000"}

1.2原因

没有对jackson进行时间格式配置

1.3解决

在application.properties中加入对jackson的时区和Date类型格式化配置:

spring.jackson.time-zone=GMT+8
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss

1.4结果

{"Date": "2019-11-17 19:39:15"}

2.MyBatis-Plus数据库字段未找到问题

2.1重现

运行就抛出org.springframework.jdbc.BadSqlGrammarException:Error querying database. Cause: java.sql.SQLSyntaxErrorException: Unknown column 'user_name' in 'field list'异常，实体类如下：

public class User implements Serializable {
    @TableId
    private Long id;

    private String userName;

}

2.2原因

MyBatis-Plus会自动将驼峰命名映射成含下划线的命名，如：userName会被转换成user_name，所以禁用这个即可。

2.3解决

在application.properties中关闭映射即可：

mybatis-plus.configuration.map-underscore-to-camel-case=false

3.Long型雪花主键返回给前端精度丢失问题

3.1重现

原本为1194942865416077314的雪花主键id返回给前端变成了：

{ "id": 1194942865416077300}

3.2原因

在Long长度大于17位时会出现精度丢失的问题（具体原因有待了解）

3.3解决

在实体类上的雪花id加上注解@JsonSerialize(using=ToStringSerializer.class)，将长整数转换成字符串输出处理，如：

public class User implements Serializable {
    @TableId
    @JsonSerialize(using = ToStringSerializer.class)
    private Long id;
}

3.4结果

{"id": "1194942865416077314"}

4.Maven依赖下载过慢

4.1原因

第一次初始化SpringBoot的时候依赖总是下到一半就卡住，因为国外网站真的是太慢了8！