Mysql-connector-java のバグで JavaからMySQLに接続できない

提供: tknotebook
移動: 案内検索

メインページ>コンピュータの部屋>MySQL


まず最初に言っておくと、以下の話は、最新のライブラリを安易にいれず、ちゃんと安定版と開発版のバージョン番号を見極め、安定版の最新をいれましょうという話です(^-^;

現象

2016.11.13 Windows版の MySQL5.7(64bit) に Javaから JDBC で接続しようとしたところ

The server time zone value '◇◇◇◇◇' is unrecognized or represents more than one time zone.

というエラーで接続できませんでした。JDBC の URL はこれ

con = DriverManager.getConnection("jdbc:mysql://localhost:3306/flashcard", "ユーザ名", "パスワード");

なんの変哲もないコードです。つながらないわけがありません。

原因

JDBC接続は久しぶりだったので、バグを疑って調べてみたところ、これはそこいらじゅうで最近起きている現象であることを発見。 mysql-connector-java の5.1.33 ~ 37 のバグでした。2015年秋から今年の2016年春までに存在していたバグです。

私の使用している mysql-connector-java は 6.0.5 のはずなのであれっと思ったのですが、よく調べると、ver6は開発版http://bugs.mysql.com/bug.php?id=79343 によれば ver.5 系(安定版)のバグフィックスがまだ ver.6系(開発版)にマージされていないようです。

メジャーバージョンの意味をよく確かめずに使ったのが敗因でした。

対処

対処法は2つあります。

JDBCの URLを変更する

今たまたま mysql-connector-java の5.1.33 ~ 37 を使っていて簡単に入れ替えられない人や、 お客様の使用されているクライアントが mysql-connector-java の5.1.33 ~ 37 を使用されている場合、 設定でしのげる以下の方法が有効でしょう。

JDBCの URL に

characterEncoding=UTF-8
serverTimezone=JST

を加えます。つまり私のコードでは

con = DriverManager.getConnection(
 "jdbc:mysql://localhost:3306/flashcard?characterEncoding=UTF-8&serverTimezone=JST", 
"ユーザ名", "パスワード");

mysql-connector-java はお行儀よく安定版(ver.5)を使う

これが正攻法。

maven central では ver5系は 2016.11.13 の時点で 5.1.40 が最新のようです。 5.1.40では正常に動くことを確認しました。

教訓

次期版だからといって、開発版には前版のバグが対処されているとは限らない。