🙈[SpringBoot] Mysql 연동🐵

2019. 9. 4.

개발환경

IntelliJ 2019.02
Java 11
SpringBoot 2.1.7
mysql-connector-java:8.0.17
Gradle 5.6

스프링부트 프로젝트를 생성할 때, 내장된 데이터베이스 h2가 아닌 MySQL을 사용하려고 했습니다.

application.properties 또는 application.yml 파일에 커넥션 정보를 작성해주면, 스프링부트가 이 정보를 오버라이드하여 MySQL을 사용할 수 있도록 한다고 하는데요.

아무리 설정을 잡아줘도 아래의 에러 때문에 Run(실행)이 안되서 고생을 했었습니다.

Description:

Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.

Reason: Failed to determine a suitable driver class

이 글에서는 위의 에러를 해결하여 MySQL을 연동하는 방법에 대해 알아보도록 하겠습니다.

1. 스프링부트 프로젝트 생성

Spring Initializr에서 Gradle로 빌드하여 스프링부트 프로젝트를 생성하도록 합니다.

의존성은 어떤걸 추가해도 상관없으며, SQL > MySQL Driver만 선택했을 경우에 build.gradle 파일은 다음과 같습니다.

build.gradle

plugins {
   id 'org.springframework.boot' version '2.1.7.RELEASE'
   id 'io.spring.dependency-management' version '1.0.8.RELEASE'
   id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

repositories {
   mavenCentral()
}

dependencies {
   implementation 'org.springframework.boot:spring-boot-starter'
   runtimeOnly 'mysql:mysql-connector-java'
   testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

2. 빌드 및 실행

프로젝트를 생성하고 빌드를 할 경우, 아래와 같은 에러가 발생할 것입니다.

Consider the following:

If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.

If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).

스프링부트에서 밀고있는 h2 데이터베이스를 사용할 경우에는 AutoConfigure에서 설정을 잡아주기 때문에 별도의 설정이 필요없습니다.

하지만 MySQL을 사용한다면 src/main/resources/application.properties 파일에서 커넥션 정보를 작성하여 설정을 잡아줘야 합니다.

src/main/resources/application.properties

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/example?serverTimezone=UTC&characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=1234

driver-class-name

com.mysql.jdbc.Driver와 com.mysql.cj.jdbc.Driver 두가지가 있습니다.
전자는 Deprecated이므로 com.mysql.cj.jdbc.Driver를 사용하도록 합니다.

localhost:3306/example

example은 database를 의미합니다.

serverTimezone=UTC

URL 쿼리 스트링에 serverTimezone을 작성해줘야 에러가 발생하지 않으므로, 꼭 작성하도록 합니다.

username / password

계정명과 비밀번호를 작성하면 됩니다.

properties 파일이 아닌, yaml로 설정할 경우 아래와 같이 작성하시면 됩니다. ( yaml이 대세라고해서 써봤어요 ㅎㅎ )

src/main/resources/application.yml

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/example?serverTimezone=UTC&characterEncoding=UTF-8
    username: root
    password: 1234

이렇게 설정을 잡고, Run(실행)을 했을 때 잘 돌아가면 연동은 이것으로 끝입니다.

3. DataSource 오류 발생 및 해결

설정을 잡아주고 실행을 했는데도 똑같은 에러가 발생한다면, 다음과 같이 처리해주시면 됩니다.

1) 라이브러리 체크

mysql-connector-java 라이브러리가 설치되어 있는지 확인합니다.