[#2 spring boot] application.yml 구성 및 MariaDB 연동 – Spring Boot 설정 완벽 가이드

이번 포스트에서는 Spring Boot 프로젝트의 핵심 설정 파일인 application.yml을 구성하고, 레거시 프로젝트에서 사용하던 MyBatis와 XML 기반 DB 설정을 Spring Boot + JPA 환경에서 MariaDB 연동으로 전환하는 방법을 다룹니다.

---

1️⃣ Spring Boot 설정 파일 개요

• application.properties vs application.yml: 두 파일은 기능적으로 동일하지만, .yml은 계층 구조를 직관적으로 표현할 수 있어 관리가 용이함.
• 설정 범위: 서버 포트, DB 연결 정보, JPA 동작, 템플릿 엔진 설정 등 프로젝트 전반의 설정을 포함.

2️⃣ MariaDB 연결 정보 구성

src/resources/application.yml   파일 추가 

 

기존 XML 설정의 context-datasource.xml에서 사용하던 MariaDB 연결 정보를 application.yml로 변환합니다.

spring:
  datasource:
    url: jdbc:mariadb://localhost:3306/your_db_name
    username: your_db_user
    password: your_db_password
    driver-class-name: org.mariadb.jdbc.Driver

  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true
    database-platform: org.hibernate.dialect.MariaDBDialect

  thymeleaf:
    cache: false

server:
  port: 8080

• spring.datasource: MariaDB 접속 정보 (로컬호스트로 수정, 사용자/비밀번호 예시로 대체)
• spring.jpa.hibernate.ddl-auto: update 설정으로 애플리케이션 실행 시 DB 스키마 자동 반영
• spring.jpa.show-sql: SQL 로그 출력
• spring.thymeleaf.cache: 템플릿 캐싱 해제 (개발 편의)
• server.port: 포트번호 지정 (기본 8080)

3️⃣ MariaDB 드라이버 의존성 추가

pom.xml에 MariaDB 드라이버 의존성을 추가해 JDBC 연결을 지원합니다.

dependency 쪽은 프로젝트 세팅 부분에서 이미 추가가 되었기 때문에 pom.xml에 있는지만 확인 

<dependency>
    <groupId>org.mariadb.jdbc</groupId>
    <artifactId>mariadb-java-client</artifactId>
</dependency>

4️⃣ 설정 적용 및 테스트

1. application.properties → application.yml: 기존 properties 파일은 제거하거나 백업.
2. src/main/resources/application.yml 경로에 작성 후 저장.
3. MariaDB 서버 동작 확인: Docker 또는 로컬에서 DB 구동 여부 점검.
4. 프로젝트 실행: Run 버튼 클릭, MariaDB 연결 성공 로그 및 SQL 로그 출력 확인.
5. 브라우저 접속: http://localhost:8080 정상 동작 확인.

5️⃣ 마무리

이번 회차에서는 Spring Boot의 application.yml을 구성하고, MariaDB 연동까지 완료했습니다. 이제 기존 XML 및 MyBatis 설정을 제거하고, Spring Boot + JPA 환경으로 본격적인 마이그레이션을 준비할 수 있습니다.

다음 회차에서는 JSP에서 Thymeleaf로 뷰 템플릿 전환을 다루겠습니다.