<aside> 📖

학습 목표

• Spring Boot 프로젝트에서 JPA를 활용한 데이터베이스 연동 환경을 스스로 구축할 수 있다.
• JPA를 사용하기 위한 필수 설정 요소(의존성, 데이터소스, 로깅)를 명확히 이해할 수 있다.
• application.yml 기반 환경설정 파일 구조와 설정 포인트를 이해하고 실무에 적용할 수 있다.
• 실습 예제를 통해 직접 설정을 적용하며 JPA 동작을 검증할 수 있다.
• PostgreSQL을 기준으로 올바른 JPA 환경을 구성할 수 있다. </aside>

1. 프로젝트 설정

JPA를 활용하기 위한 Spring Boot 프로젝트의 환경 구성을 단계별로 설명합니다.

1-1. 의존성 추가 (Gradle)

build.gradle 예시 (Spring Boot 3.x 기준)

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.5'
    id 'io.spring.dependency-management' version '1.1.4'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa' // JPA
    implementation 'org.postgresql:postgresql:42.7.3'                     // PostgreSQL 드라이버
    implementation 'org.springframework.boot:spring-boot-starter-web'     // REST API
    testImplementation 'org.springframework.boot:spring-boot-starter-test' // 테스트
}

💡 실무 팁

• JPA는 spring-boot-starter-data-jpa 하나로 충분.
• PostgreSQL 버전은 DB 서버 버전과 맞추는 것이 안정적.

1-2. 데이터소스 설정

1-2-1. 디렉토리 구조 (resources)

src/main/resources/
├── application.yml
└── static/

1-2-2. application.yml 예시

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/exampledb # DB이름 설정 필요
    username: exampleuser
    password: examplepw
    driver-class-name: org.postgresql.Driver
  jpa:
    hibernate:
      ddl-auto: update # 개발 단계는 update, 운영은 none 권장
    show-sql: true       # 실행 쿼리 확인
    properties:
      hibernate:
        format_sql: true # SQL 포맷팅 가독성

💡 실무 팁

• 운영 환경에서는 ddl-auto는 none으로 변경.
• URL 포트, DB명, 계정정보는 보안상 환경변수로 관리.

1-3. JPA 설정 설명

1-3-1. ddl-auto 옵션 비교