Mysql-connector-java のバグで Javaから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では正常に動くことを確認しました。
教訓
次期版だからといって、開発版には前版のバグが対処されているとは限らない。