[MySQL] The server time zone value is unrecognized or represents more than one time zone 에러 해결 방법

The server time zone value is unrecognized or represents more than one time zone 에러 해결 방법

Java에서 로컬 MySQL 서버에 연결하던 중 아래와 같은 에러가 발생했다.

 

java.sql.SQLException: The server time zone value is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

 

해석하면 '서버 시간대 값이 인식되지 않거나 둘 이상의 시간대를 나타낸다. 서버 또는 JDBC 드라이버(serverTimezone configuration property를 통해)를 구성하여 더 구체적인 표준 시간대 값을 사용해야한다.' 라는 뜻이다.

 

현재 MySQL의 GLOBAL(전역) 및 SESSION time zone(시간대) 값은 다음과 같이 확인할 수 있다.

 

SELECT @@GLOBAL.time_zone, @@SESSION.time_zone;

'SYSTEM'은 MySQL 서버 시간대가 시스템 시간대와 동일한 것으로써 구체적인 명시가 되어있지 않음을 나타낸다. 이 때문에 Exception이 발생한 것이다. 아래의 방법 중 하나를 택하여 시간대를 지정하면 해결된다.

 

방법 1: SET Statement 실행

이 방법은 런타임에 서버 시간대 값을 설정할 수 있다. 시간대는 UTC로부터의 오프셋을 나타내는 문자열로 지정할 수 있다. UTC로 지정하려면 '+0:00'으로, KST로 지정하려면 다음과 같이 '+9:00'으로 지정해주면 된다.

 

SET GLOBAL time_zone = '+9:00';    # 권한 필요
SET time_zone = '+9:00';

 

SET GLOBAL time_zone은 실행하려면 권한이 필요하다.

 

방법 2: default-time-zone 옵션 지정

이 방법은 서버 재기동이 필요하다. 서버 구동 시 명령줄에 --default-time-zone 옵션을 사용하거나 my.ini 파일의 [mysqld]에 추가한다.

 

my.ini에 default-time-zone 옵션 추가

my.ini 수정 후 MySQL 서버를 재기동한다.

 

방법1 또는 방법2를 적용하면 아래와 같이 MySQL 서버 시간대가 변경되며 자바에서 정상적으로 연결할 수 있다.

 

방법1 또는 방법2 적용 후 서버 시간대

 

방법 3: JDBC Properties 설정

이 방법은 MySQL 서버와 상관 없이 JDBC와 연결 시 속성값을 설정해서 시간대를 override(재정의)하는 방법이다. MySQL 서버 시간대가 변경되지 않는다.

 

연결 메소드를 호출할 때 serverTimezone property를 넘기거나 JDBC URL에 추가한다.

단 MySQL 서버의 시간대를 지정하는 것과 달리 한국 시간은 Asia/Seoul 값을 지정해야 한다.

 

properties.setProperty("serverTimezone", "Asia/Seoul");
try {
    DriverManager.registerDriver(new com.mysql.cj.jdbc.Driver());
    conn = DriverManager.getConnection("jdbc:mysql://localhost:3307/knou", properties);

<Properties 객체에 담아 넘겨서 설정>

 

try {
    DriverManager.registerDriver(new com.mysql.cj.jdbc.Driver());
    conn = DriverManager.getConnection("jdbc:mysql://localhost:3307/knou?serverTimezone=Asia/Seoul", properties);

<JDBC URL에 붙여서 설정>

 

참고로 serverTimezone은 서버의 표준 시간대가 Java 표준 시간대로 매핑되지 않을 때 사용되는 속성이다.

 

References

https://dev.mysql.com/doc/refman/8.0/en/time-zone-support.html

https://offbyone.tistory.com/318