mybatis mysql schema_MyBatis Generator踩坑与自救

前言

我最近在使用MyBatis Generator的过程中遇到了点问题，网上虽然已有相关的解决方案，但结果不尽人意，都只是在规避问题，并没有真正的解决问题。所以我亲自操刀，深入源码，窥探其背后的秘密。

在进行了一番调试分析后，俺最终将问题解决了。这里就跟大伙剖析下鄙人是如何折腾的。

环境

JAVA8

数据库mysql 5.7

mysql驱动mysql-connector-java-6.0.6.jar

Mybatis Generator 1.3.5

问题

我本机的mysql数据库里面有个名为piwik的“schema”，里面有张表piwik_log_action，我想通过MyBatis Generator(以下简称为MBG)生成这张表的entity、mapper等文件。

但是执行MBG后，发现mapper里没有selectByPrimaryKey、updateByPrimaryKey等与主键相关的方法，而表里面是有主键的。

后来发现，执行MBG的时候控制台出现了这样的警告信息：Cannot obtain primary key information from the database, generated objects may be incomplete。意思是无法获取数据库的主键信息，那么当然就无法生成byPrimaryKey的方法了。

下面是我的generatorConfig.xml配置信息。

/p>

PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"

"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

connectionURL="jdbc:mysql://localhost:3306/piwik?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC"

userId="root"

password="123456">

targetProject="service-ua/src/main/java">

定位

考虑到我之前使用MBG1.3.2以及mysq驱动5.1.42，生成的mapper是没问题的，所以问题出现的原因就锁定在版本上了。OK，我轮番切换版本号，最后发现mysql驱动为5.1.42版本的时候，MBG不管是新旧版本都木有问题。反之，mysql驱动为6.0.6时，生成的mapper都是没有byPrimaryKey方法的。那么显然问题就出现在mysq驱动的版本上。

OK，那么驱动用旧版本的就行了。Nonono，对于敢于尝试新事物的我，当然不会屈就于用旧版本的驱动来规避这个问题啦。

那么，开启源码调试模式。

调试

首先，我先使用6.0.6的驱动，然后使用java形式的来执行MBG，代码如下

public class MybatisGeneratorExecutor {

public static void main(String[] args) throws IOException, XMLParserException, InvalidConfigurationException, SQLException, InterruptedException, URISyntaxException {

List warnings = new ArrayList<>();

boolean overwrite = true;

File configFile = new File(MybatisGeneratorExecutor.class.getResource("generatorConfig.xml").toURI());

Configuration config = new ConfigurationParser(warnings).parseConfiguration(configFile);

DefaultShellCallback callback = new DefaultShellCallback(overwrite);

MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);

myBatisGenerator.generate(null);

warnings.forEach(System.out::println);

}

}

这里，我注意到变量warnings是用来接收MBG执行时的警告信息，所以说只要找到了给这个变量添加了上述“找不到主键的警告信息”的代码，那么问题将迎刃而解。

果然，当执行到org.mybatis.generator.api.MyBatisGenerator的257行时。

context.introspectTables(callback, warnings, fullyQualifiedTableNames);

warnings就被赋值了，如下图所示。

image.png

OK，继续深追，看看具体在哪行代码赋值的。一直dig一直dig，经过一番微操后，终于发现在执行org.mybatis.generator.internal.db.DatabaseIntrospector的calculatePrimaryKey方法时，出现了异常SQLException

image.png

异常的描述为Unknown table 'piwik_log_action' in information_schema，其中information_schema是数据库中的第一个“schema”，当时我感到很奇怪，为什么会在information_schema上面找这张表了，这张表我已经在generatorConfig.xml里配置了“schema”为piwik的。

让我们在深入调查下calculatePrimaryKey方法究竟发生了什么事情。再深入调试，进入com.mysql.cj.jdbc.DatabaseMetaData的getPrimaryKeys方法，在这里，我发现异常就出现在执行代码rs = stmt.executeQuery(queryBuf.toString());,其中queryBuf.toString()的值为

SHOW KEYS FROM `piwik_log_action` FROM `information_schema`，显然information_schema是没有那张表的，所以就出现sql异常了。

image.png

我看到他是迭代getCatalogIterator(catalog)的返回值catalogStr就是information_schema，那么这个值是怎么来的，再看看getCatalogIterator方法吧。

image.png

调试后发现进入的是最后一个分支，而这里就得到了数据库中所有的“schema”，而刚好我的数据库中的第一个“schema”就是information_schema，所以在遍历的时候，第一个取得就是他。

image.png

OK，到这里我就算找到了6.0.6版本的问题出在哪，但是还不知道怎么解决，这时我就想到与5.1.42版本的做下对比，看看旧版本为啥没问题。

将mysql驱动改为5.1.42版本，再次进入源码调试模式。

直接进入com.mysql.jdbc.DatabaseMetaData，发现他进入的是第二个分支，然后获取的值刚好是“piwik”。

image.png

看来问题出在nullCatalogMeansCurrent，虽然两个版本的获取方式不同，但这个东东其实是连接mysql驱动的属性，在5.1.42中默认是true，而在6.0.6默认为false。

那这样的话，在连接串中加入nullCatalogMeansCurrent=true就行了。

jdbc:mysql://localhost:3306/piwik?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC&nullCatalogMeansCurrent=true

果然，加上后警告提示没了，byPrimaryKey的方法也都有了。Oh yeah!

OK，到这里，问题已经解决了。Nonono，问题似乎并没有这么simple，怎么说呢，因为机智的我发现里面还有玄机，来来来，请看下文分解。

在调试的过程中，看到过msyql驱动的源码里有这样的代码注释--“No schemas in MySQL”，不仅是6的版本，5的版本也是这么描述的。

image.png

看到这个我就开始觉得不对劲了，再加上前面的nullCatalogMeansCurrent属性，我铁定的怀疑我的配置出问题了。

前面给大家看了我在generatorConfig.xml里的配置

有个属性就是配置的schema，那mysql没有schema的话，那么这咋整，机智的我跑去MBG官网看了下

image.png

此时我把table的配置schema改成了catalog。然后把连接串的nullCatalogMeansCurrent=true去掉。执行generator后发现还果真可以正常生成byPrimaryKey的方法。

这时我才知道，原来使用mysql驱动连接mysql时，指定数据库是用catalog，而不是schema。

那nullCatalogMeansCurrent就好理解了，因为之前配置的是schema="piwik"，那么catalog就是null了，null的话就means current，就取当前的catalog，这个catalog就是连接串jdbc:mysql://localhost:3306/piwik里的“piwik”。

OK，既然

最终形态

/p>

PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"

"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

connectionURL="jdbc:mysql://localhost:3306?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC"

userId="root"

password="123456">

targetProject="service-ua/src/main/java">

总结

自己遇到的问题能够独立解决固然是好事，但是，如果深入问题的本质，就会发觉自己的不足。如果我能够更好的了解Mysql，根本就不会出现这样的问题。如果我能更好的了解MBG的配置，在配置有误后也能快速解决问题。所以说，要对自己的将要使用的武器有足够的了解，否则不仅无法发挥它们的最大作用，还有可能自损八百，得不偿失。

然后，我还是有疑问，就是catalog和schema在mysql里面究竟是怎么个情况，我在官网没有找到相关资料，网上有些人说schema就是database，也有人说database==schema==catalog，但是，按sql标准，database包含catalog，catalog包含schema。实在是搞不懂，摸不透。

难道mysql真的没有schema吗？有没有大神解答下呀。