팀프로젝트

# PR 이후 다양한 build 오류 해결

KimMZ 2025. 2. 17. 19:00

생각보다 자주 발생하는 build 오류 유형

1. git clone 또는 프로젝트를 열 때, 오류

더보기
더보기
더보기

1)  로컬 환경마다 gradle 버전이 다르므로 git 히스토리에 gradle 생성하지 않음. 오류 발생 시, .gradle 또는 gradle 폴더 삭제 후, 다시 build

2)  gradle 버전이 맞지 않기 때문에 발생하는 오류로 호환 가능한 gradle 버전으로 변경(gradle.wrapper.properties)

Casue: zip END header not found

 

2. .env 환경변수 값의 오타로 인한 오류

더보기
더보기
더보기

- docker-compose.yaml 파일의 db.driver의 username, password, DB는 로컬 환경마다 다르게 설정

- spring-security 에 사용되는 key 값 : 한글 포함X

# postgreSQL 설정
POSTGRES_USER=postgres
POSTGRES_PASSWORD=비밀번호
POSTGRES_DB=db명

SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/db명
SPRING_DATASOURCE_USERNAME=postgres
SPRING_DATASOURCE_PASSWORD=비밀번호

SECRET_KEY=키값 # 한글 입력 시, 오류

 

3. docker-compose.yml에서 처음 build 할 때, Hibernate를 이용하여 DDD 된다. 이후, Entity의 컬럼 중 1개의 데이터 타입을 변경하여 다시 build 할 경우 타입 수정이 안되기 때문에 오류 발생.

  •  docker desktop에서 container를 삭제 후, 재실행하면 오류 없이 정상 작동

 

다양한 원인의 build 오류가 발생할 수 있음!
추후, 오류 발생 시 업데이트 예정!