Mysql-tinyint使用之实际采坑记

使用tinyint(1) 用来存储枚举时候的坑

场景描述：

公司某个系统分别在dev,test等多个环境进行部署，但是某一天在联调过程中发现dev环境的很多地方的枚举值无法正常显示 均为null。但是在其他多个环境，均能正常显示。有点懵逼，然后开启排查模式ing....

问题排查

1. 保证在dev,test环境发布同样的分支

   结果：test环境ok,dev环境任然异常-->排除代码问题

2. 在dev环境，本地 使用同一个数据库查询

   结果：本地环境ok,dev环境任然异常-->排除数据问题

3. 找运维临时开放远程debug端口

   本地远程debug,果真枚举显示null异常--->确定是开发环境的问题

   3.1 去私服上下载刚打包的项目jar 本地引用后使用

   结果：显示正常 -->排除部署的jar包问题

   3.2 去开发环境机器上获取相关配置文件进行对比

   结果：配置文件存在差异。修复差异后重新部署 ->dev环境显示正常

问题出现的根源：原先我司xxx系统是dev,test 将相关的配置文件打包至jar中，使用项目中的配置文件。最近由运维团队统一管理配置文件。运维小伙伴在维护dev配置文件时候，dev相关的配置未与代码中保持一致（dev环境缺少 tinyInt1isBit=false）。

事后详细学习下tinyInt1isBit=false 的作用

JAVA数据类型 和 MYSQL的数据类型转换，要注意tinyInt 类型，且存储长度为1的情况。

先看下mysql官网的介绍

java.lang.Boolean if the configuration property tinyInt1isBit is set to true (the default) and the storage size is 1, or java.lang.Integer if not.

tinyInt(1) 只用来代表Boolean含义的字段，且0代表False，1代表True。如果要存储多个数值，则定义为tinyInt(N), N>1。例如 tinyInt(2)

项目中需要使用枚举时候（0：默认，1:成功，2:失败，3:异常，4:未知错误...），有两种方式可以正常展示枚举

方式1：

JDBC的URL增加 tinyInt1isBit=false参数，注意参数名区分大小写，否则不生效

jdbc:mysql://${ucmha.proxy1_2.host}/${db.mysql.db}?tinyInt1isBit=false

方式2：

一定要用tinyint就增加长度（tinyInt(N), N>1 比如tinyint(4)）

实测分析

场景1：tinyInt1isBit 使用默认值true and 使用tinyint(1)

#alter table tableA add COLUMN  `return_type` tinyint(1) NOT NULL DEFAULT '0' COMMENT '状态(0未审批 1审批通过 2审批拒绝 3 拒绝失败 4 拒绝中)';
spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useAffectedRows=true

会发现实际java代码中查询实体后，对于枚举值的展示均出现异常，显示为 null

 场景2：tinyInt1isBit 使用false and 使用tinyint(1)

#alter table tableA add COLUMN  `return_type` tinyint(1) NOT NULL DEFAULT '0' COMMENT '状态(0未审批 1审批通过 2审批拒绝 3 拒绝失败 4 拒绝中)';
spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&tinyInt1isBit=false&useAffectedRows=true

可正常显示枚举

场景3：tinyInt1isBit 使用默认值true and 使用tinyint(n) (n>1)

#alter table tableA add COLUMN  `return_type` tinyint(2) NOT NULL DEFAULT '0' COMMENT '状态(0未审批 1审批通过 2审批拒绝 3 拒绝失败 4 拒绝中)';
spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useAffectedRows=true

tinyint(n) (n>1) 可正常显示枚举