[Spring Boot] 개발/테스트 환경에서 인메모리 DB 설정하는 방법

705 words

4 minutes

[Spring Boot] 개발/테스트 환경에서 인메모리 DB 설정하는 방법

2025-04-24

Spring Boot

/

Test

/

H2

/

Redis

/

In-memory DB

/

Configuration

개요#

Spring Boot 애플리케이션을 개발할 때, 로컬 및 테스트 환경에서 인메모리 데이터베이스 (H2 Database, Embedded Redis) 를 사용하면 별도 컨테이너나 외부 프로세스를 띄우지 않고 쉽고 빠르게 테스트 환경을 구성할 수 있다.

이 글에서는 Spring Boot의 로컬 개발, 테스트 환경에서 H2 Database 와 Embedded Redis 를 설정하는 방법을 다룬다.

H2 Database 설정하기#

먼저 build.gradle 에 H2 데이터베이스 의존성을 추가한다.

1
dependencies {
2
  runtimeOnly 'com.h2database:h2'
3
}

그리고 application-local.yml (또는 application-test.yml) 파일에 다음과 같이 설정한다.

1
spring:
2
  datasource:
3
    url: jdbc:h2:mem:test
4
    username: sa
5
    password:
6

7
  h2:
8
    console:
9
      enabled: true
10
      path: /h2-console

h2-console 설정을 활성화하면 로컬 서버 실행 시 http://localhost:8080/h2-console 경로에서 웹 기반 콘솔을 사용할 수 있다.
H2는 인메모리 기반이므로 애플리케이션이 꺼지면 데이터도 함께 사라집니다.

Embedded Redis 설정하기#

다음의 라이브러리를 사용한다.

codemonstur

/

embedded-redis

Waiting for api.github.com...

00K

0K

Waiting...

build.gradle 에 라이브러리를 추가한다.

1
implementation 'com.github.codemonstur:embedded-redis:1.4.3'

EmbeddedRedisConfiguration.java 을 작성한다.

1
@Configuration
2
@Profile({"local", "test"}) // 로컬 및 테스트 환경에서만 활성화
3
public class EmbeddedRedisConfiguration {
4

5
 @Value("${spring.data.redis.port}")
6
 private int redisPort;
7

8
 private RedisServer redisServer;
9

10
 @PostConstruct
11
 public void startRedis() throws IOException {
12
  try {
13
   redisServer = new RedisServer(redisPort);
14
   redisServer.start();
15
  } catch (Exception e) {
16
   if (isRedisRunning()) {
17
    return; // 이미 실행 중인 경우 무시
18
   }
19
   throw e;
20
  }
21
 }
22

23
 @PreDestroy
24
 public void stopRedis() throws IOException {
25
  if (redisServer != null && redisServer.isActive()) {
26
   redisServer.stop();
27
  }
28
 }
29

30
 private boolean isRedisRunning() {
31
  try (Socket socket = new Socket()) {
32
   socket.connect(new InetSocketAddress("localhost", redisPort), 100);
33
   return true;
34
  } catch (IOException e) {
35
   return false;
36
  }
37
 }
38
}

이 설정은 다음과 같은 조건에서 작동한다:

현재 지정된 포트에 Redis가 이미 실행 중이면, Embedded Redis를 실행하지 않는다.
로컬 및 테스트 프로파일에 한해 활성화되므로 운영 환경에는 영향이 없다.

테스트 코드#

인메모리 환경에서 H2 DB와 Redis 설정이 잘 적용되었는지 다음과 같은 테스트 코드로 확인할 수 있다.

H2 Database 테스트#

1
@SpringBootTest
2
@ActiveProfiles("test") // H2 설정이 활성화되어 있는 프로파일
3
class H2Test {
4

5
    @Autowired
6
    private DataSource dataSource;
7

8
    @Test
9
    @DisplayName("H2 데이터베이스에 직접 쿼리를 날려 테이블을 생성하고 데이터를 저장할 수 있다")
10
    void shouldInsertAndSelectUsingRawJdbc() throws Exception {
11
        try (Connection conn = dataSource.getConnection()) {
12
            // 테이블 생성
13
            conn.createStatement().executeUpdate("CREATE TABLE test_user (id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(255))");
14

15
            // 데이터 삽입
16
            conn.createStatement().executeUpdate("INSERT INTO test_user (username) VALUES ('h2test')");
17

18
            // 데이터 조회
19
            ResultSet rs = conn.createStatement().executeQuery("SELECT username FROM test_user WHERE id = 1");
20

21
            assertThat(rs.next()).isTrue();
22
            assertThat(rs.getString("username")).isEqualTo("h2test");
23
        }
24
    }
25
}

Embedded Redis 테스트#

1
@SpringBootTest
2
@ActiveProfiles("test") // EmbeddedRedisConfiguration이 활성화된 프로파일
3
class RedisTemplateTest {
4

5
    @Autowired
6
    private StringRedisTemplate redisTemplate;
7

8
    @Test
9
    @DisplayName("Embedded Redis에 값을 저장하고 조회할 수 있다")
10
    void shouldSetAndGetValueDirectlyUsingRedisTemplate() {
11
        // given
12
        String key = "redis:test";
13
        String value = "check";
14

15
        // when
16
        redisTemplate.opsForValue().set(key, value);
17
        String result = redisTemplate.opsForValue().get(key);
18

19
        // then
20
        assertThat(result).isEqualTo("check");
21
    }
22
}