Spring Boot가 데이터베이스와 대화하려면 두 가지 도구가 필요합니다. 하나는 SQL을 실행하는 도구(JdbcTemplate)이고, 다른 하나는 PostgreSQL과 통신하는 드라이버입니다. 이 두 가지를 프로젝트에 추가해 볼게요.

1-1. build.gradle 파일 열기

프로젝트 루트 폴더의 build.gradle 파일을 엽니다.

파일: build.gradle

1-2. dependencies 블록에 의존성 추가

dependencies { ... } 블록 안에 아래 두 줄을 추가합니다.

dependencies {
    // ... 기존 의존성들 ...
    
    // JdbcTemplate와 DataSource 자동 설정을 위한 스타터
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
    
    // PostgreSQL JDBC 드라이버 (런타임에만 필요)
    runtimeOnly 'org.postgresql:postgresql'
}

왜 runtimeOnly인가? PostgreSQL 드라이버는 우리가 코드를 작성할 때 직접 import해서 사용하지 않습니다. 프로그램이 실행될 때(run할 때) Spring이 자동으로 드라이버를 찾아서 연결하기 때문에, 컴파일 시점에는 필요 없고 실행 시점에만 필요하므로 runtimeOnly로 설정합니다.

✅ 확인

터미널에서 아래 명령을 실행하여 컴파일이 정상적으로 되는지 확인합니다.

cd backend
./gradlew compileJava

• BUILD SUCCESSFUL 이 표시됩니다.
• 에러가 없다면 성공입니다.

🎓 newlec 쌤의 코멘트

식당 비유로 설명하면, spring-boot-starter-jdbc 는 주방에 있는 '전자레인지' 같은 도구입니다. 우리가 직접 불을 다루지 않고, 버튼만 누르면(코드를 적으면) 내부적으로 복잡한 과정(연결, 쿼리 실행)을 처리해 줍니다. postgresql 드라이버는 그 전자레인지가 우리 가게의 특수한 재료(PostgreSQL)를 처리할 수 있도록 해주는 '어댑터'입니다. 이 두 가지가 없으면 Spring은 데이터베이스와 어떻게 대화해야 할지 모릅니다.

❌ 자주 하는 실수

📝 이 단계의 핵심

• spring-boot-starter-jdbc: JdbcTemplate 사용 가능하게 해주는 스타터
• org.postgresql:postgresql: PostgreSQL 연결용 드라이버 (runtimeOnly)