Gradle Build 시 에러 발생

1. 현재 학습 진도

• 몇 챕터/몇 강을 수강 중이신가요?

  • 2-7강

     

• 여기까지 이해하신 내용은 무엇인가요?

  • git Action CI/CD

2. 어려움을 겪는 부분

• 어느 부분에서 막히셨나요?

  • git push 후 workflow에서 Gradle 빌드 실패

• 코드의 어떤 로직이 이해가 안 되시나요?

• 어떤 개념이 헷갈리시나요?

3. 시도해보신 내용

• 문제 해결을 위해 어떤 시도를 해보셨나요?

• 에러가 발생했다면 어떤 에러인가요?

  • git push 후 workflow에서 Gradle 빌드 실패

• 현재 작성하신 코드를 공유해주세요

   

빌드를 진행할 때 먼저 3개의 테스트에서 실패합니다.

SimpleEventListenerTest > 현재 코드 구조에서 @TransactionalEventListener는 작동하지 않는다 FAILED
    java.lang.IllegalStateException at DefaultCacheAwareContextLoaderDelegate.java:143
        Caused by: org.springframework.beans.factory.BeanCreationException at AbstractAutowireCapableBeanFactory.java:1770
            Caused by: jakarta.persistence.PersistenceException at AbstractEntityManagerFactoryBean.java:421
                Caused by: org.hibernate.exception.JDBCConnectionException at SQLExceptionTypeDelegate.java:49
                    Caused by: java.sql.SQLNonTransientConnectionException at SQLError.java:111
SimpleEventListenerTest > @TransactionalEventListener는 활성 트랜잭션이 필요하다 FAILED
    java.lang.IllegalStateException at DefaultCacheAwareContextLoaderDelegate.java:143
        Caused by: org.springframework.beans.factory.BeanCreationException at AbstractAutowireCapableBeanFactory.java:1770
            Caused by: jakarta.persistence.PersistenceException at AbstractEntityManagerFactoryBean.java:421
                Caused by: org.hibernate.exception.JDBCConnectionException at SQLExceptionTypeDelegate.java:49
                    Caused by: java.sql.SQLNonTransientConnectionException at SQLError.java:111
SimpleEventListenerTest > @EventListener는 트랜잭션이 없어도 정상 동작한다 FAILED
    java.lang.IllegalStateException at DefaultCacheAwareContextLoaderDelegate.java:143
        Caused by: org.springframework.beans.factory.BeanCreationException at AbstractAutowireCapableBeanFactory.java:1770
            Caused by: jakarta.persistence.PersistenceException at AbstractEntityManagerFactoryBean.java:421
                Caused by: org.hibernate.exception.JDBCConnectionException at SQLExceptionTypeDelegate.java:49
                    Caused by: java.sql.SQLNonTransientConnectionException at SQLError.java:111

이후, Redis에 Reconnecting 하려고 시도하지만 Connection이 Refused되면서 빌드에 실패합니다.

2025-08-21T08:34:32.560Z  INFO 2235 --- [xecutorLoop-1-2] i.l.core.protocol.ConnectionWatchdog     : Reconnecting, last destination was localhost/127.0.0.1:32770
2025-08-21T08:34:32.570Z  WARN 2235 --- [ioEventLoop-8-2] i.l.core.protocol.ConnectionWatchdog     : Cannot reconnect to [localhost/<unresolved>:32770]: Connection closed prematurely
io.lettuce.core.RedisConnectionException: Connection closed prematurely
	at io.lettuce.core.protocol.RedisHandshakeHandler.channelInactive(RedisHandshakeHandler.java:91) ~[lettuce-core-6.2.6.RELEASE.jar:6.2.6.RELEASE]

// 생략

로컬 환경과 AWS EC2 환경에서 동일하게 발생합니다.

해결 방법

gradle build를 5번 정도 시도했는데, 5번 중 4번은 SimpleEventListenerTest에서 테스트가 실패하고, 1번은 다른 Test에서 실패하였습니다.

그래서, SimpleEventListenerTest에 대해 개별 테스트를 진행해보니 통과하였습니다.

전체 테스트 진행에서는 JDBC Connection 관련 오류가 발생했고, 개별 테스트 진행에서는 문제가 발생하지 않는다는 점에서 커넥션 풀 설정 문제를 의심하였습니다.

spring:
  datasource:
    url: jdbc:mysql://${RDS_ENDPOINT:localhost}:3306/portfolio?useSSL=false&serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true&useSSL=false&rewriteBatchedStatements=true
    username: portfolio_user
    password: ${RDS_PASSWORD:portfolio1234}
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 32

@TestConfiguration
public class TestDatabaseConfig {
    
    @Container
    private static final MySQLContainer<?> mysqlContainer;

application.yml 의 최대 풀 사이즈는 32로 설정되어 있고, mySQL 컨테이너는 전역으로 설정되어 있으므로 병렬 처리 과정에서 커넥션 풀이 부족할 수 있겠다는 판단하에, maximum-pool-size를 100으로 늘려보았습니다.

package ding.co.backendportfolio.config;

import jakarta.annotation.PreDestroy;
import org.springframework.boot.test.context.TestConfiguration;
import org.springframework.context.annotation.Bean;
import org.testcontainers.containers.MySQLContainer;
import org.testcontainers.junit.jupiter.Container;

@TestConfiguration
public class TestDatabaseConfig {
    
    @Container
    private static final MySQLContainer<?> mysqlContainer;

    static {
        mysqlContainer = new MySQLContainer<>("mysql:8.0.33")
                .withDatabaseName("testdb")
                .withUsername("test")
                .withPassword("test");
        mysqlContainer.start();

        // A) 기본 설정 + rewriteBatchedStatements 옵션
        String originalJdbcUrl = mysqlContainer.getJdbcUrl() + "?rewriteBatchedStatements=true";

        // TODO: BulkInsert 모니터링 - 아래 주석을 해제해야함
//        originalJdbcUrl = originalJdbcUrl + "&profileSQL=true&logger=Slf4JLogger&maxQuerySizeToLog=2147483647";

        System.setProperty("spring.datasource.url", originalJdbcUrl);
        System.setProperty("spring.datasource.username", mysqlContainer.getUsername());
        System.setProperty("spring.datasource.password", mysqlContainer.getPassword());

        // 커넥션 풀 늘리기
        System.setProperty("spring.datasource.hikari.maximum-pool-size", "100");
        System.setProperty("spring.datasource.hikari.minimum-idle", "10");
    }

    @Bean
    public MySQLContainer<?> mySQLContainer() {
        return mysqlContainer;
    }

    @PreDestroy
    public void stop() {
        if (mysqlContainer != null && mysqlContainer.isRunning()) {
            mysqlContainer.stop();
        }
    }
} 

이후 테스트를 진행해보니, 기존에 작성해두신 커넥션 풀 테스트인 EventJoinWithExternalConnectionPoolTest를 제외하고 테스트에 통과하였습니다.

따라서, EventJoinWithExternalConnectionPoolTest이 테스트에만 작은 커넥션 풀을 적용하도록 하였습니다.

@Slf4j
@IntegrationTest
// 커넥션 설정
@TestPropertySource(properties = {
    "spring.datasource.hikari.maximum-pool-size=32",
    "spring.datasource.hikari.minimum-idle=5"
})
class EventJoinWithExternalConnectionPoolTest {

문제가 발생한 원인은, Gradle 병렬 테스트 진행 시 커넥션 풀이 부족하여 커넥션이 이뤄지지 않았던 것 같습니다.

사실 최대 커넥션 풀을 100개로 늘리는 건 임시방편인 것 같고, 테스트별로 독립적인 컨테이너 환경을 만들어주는게 좋을 것 같다고 생각합니다.

P.S.) GPT, 클로드코드, Cursor, ... 다 문제 원인을 파악하지 못하더라고요 ㅎㅎ