Spring Boot Application Failed to Start: Failed to configure a DataSource

Spring Boot 애플리케이션을 실행하려고 할 때 아래와 같은 오류 메시지가 나타날 수 있습니다:

***************************
APPLICATION FAILED TO START
***************************

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

Action:

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).

Process finished with exit code 0

이 오류는 Spring Boot가 애플리케이션 실행 시 데이터베이스(DataSource)를 구성할 수 없을 때 발생합니다. 데이터베이스 연결 설정이 누락되었거나 올바르지 않을 때 자주 발생합니다. 아래에서 이 문제를 해결하는 방법을 단계별로 알아보겠습니다.

해결 방법

1. application.properties 또는 application.yml 파일 확인하기

Spring Boot에서 데이터베이스 연결 정보를 설정하려면 application.properties 또는 application.yml 파일에 적절한 설정을 추가해야 합니다. 예를 들어, MySQL 데이터베이스를 사용하는 경우 아래와 같은 설정을 추가합니다.

application.properties:

spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

application.yml:

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database_name
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

2. 데이터베이스 드라이버 의존성 추가하기

Spring Boot 애플리케이션이 데이터베이스에 연결하려면 적절한 JDBC 드라이버 의존성이 프로젝트에 포함되어야 합니다. 예를 들어, MySQL을 사용하는 경우 pom.xml에 아래와 같은 의존성을 추가합니다:

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

Gradle을 사용하는 경우 build.gradle에 다음을 추가합니다:

dependencies {
    runtimeOnly 'mysql:mysql-connector-java'
}

3. 데이터베이스가 실행 중인지 확인하기

애플리케이션이 사용하는 데이터베이스가 실행 중인지 확인하세요. 데이터베이스 서버가 꺼져 있거나 접근할 수 없는 경우에도 위 오류가 발생할 수 있습니다.

• MySQL, PostgreSQL 등의 데이터베이스가 로컬 환경에서 실행 중인지 확인하세요.
• 데이터베이스 호스트, 포트, 사용자 이름 및 비밀번호가 올바른지 점검하세요.

4. 프로파일 활성화하기

Spring Boot는 프로파일 기반 설정을 지원합니다. 특정 프로파일에서 데이터베이스 설정을 관리하는 경우 해당 프로파일을 활성화해야 합니다. 예를 들어, application-dev.properties 파일에 데이터베이스 설정이 포함된 경우 application.properties 파일에 다음과 같은 내용을 추가합니다:

spring.profiles.active=dev

또는 애플리케이션 실행 시 명령줄 인수를 사용하여 프로파일을 활성화할 수도 있습니다:

java -jar your-application.jar --spring.profiles.active=dev

5. 기본 내장 데이터베이스 사용하기

만약 내장 데이터베이스(H2, HSQL, Derby 등)를 사용하려는 경우 해당 의존성을 프로젝트에 추가하고 설정 파일에 별도의 URL을 지정하지 않아도 됩니다. H2 데이터베이스의 경우:

pom.xml:

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

application.properties:

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

6. Spring Boot 스타터 의존성 확인하기

Spring Boot 스타터 의존성 중 spring-boot-starter-data-jpa 또는 spring-boot-starter-jdbc가 누락된 경우에도 위와 같은 오류가 발생할 수 있습니다. pom.xml에 아래와 같은 의존성을 추가하세요:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

Gradle을 사용하는 경우:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
}

---

English Korean Japanese Chinese (Simplified) Chinese (Traditional) Vietnamese Indonesian Thai German Russian Spanish Italian French

Copy

이 확장을 지원합니다