🛡️ Spring Boot 4.0.4 & Java 25 작업일지

Last Updated: 2026년 04월 13일

근 1년동안 손을 안대고 있는중에 업데이트 되었다고해서 무조건 최신으로 했더만 여러가지 문제점이 발생을 하네. 일단 정리를 좀 해야겠다는 생각에 작업하면서 발생한 문제점 또는 바뀐점을 하나하나 추가를 한다.
[2026.03.29] 문서 최초 작성 및 build.gradle 추가
[2026.04.12] gradle 한글 깨짐 현상 수정

• Java 25 + Spring Boot 4.0.4 + Redis + Leaflet + ApexCharts + 캐러셀(Carousel)
• Redis 사용 – https://upstash.com/

• 50% 축소된 작업 화면 이미지.

• 작업 디렉토리 구조

D:.
├─java
│  └─kr
│      └─narrator
│          ├─common (공통 인프라 로직)
│          │  ├─domain (BaseTimeEntity 등등)
│          │  ├─dto (ApiResponse 같은 전역 응답 규격을 관리)
│          │  ├─exception
│          │  └─utils (IP 추출 로직 등을 분리)
│          ├─config (애플리케이션의 뼈대 설정, RedisConfig와 JpaAuditConfig 등등)
│          ├─domains (비즈니스 로직의 심장부)
│          │  ├─dashboard (메인 화면)
│          │  │  ├─controller
│          │  │  ├─dto
│          │  │  └─service
│          │  └─visitor (방문자 관련 기능)
│          │      ├─controller
│          │      ├─dto
│          │      ├─entity
│          │      ├─repository
│          │      └─service
│          └─test
└─resources
    ├─static
    │  ├─css
    │  │  └─libs
    │  │      ├─bootstrap
    │  │      └─sweetalert2
    │  ├─fonts
    │  ├─images
    │  │  ├─brands
    │  │  ├─flags
    │  │  ├─svg
    │  │  └─users
    │  ├─js
    │  │  ├─libs
    │  │  │  ├─bootstrap
    │  │  │  ├─choices
    │  │  │  ├─feather-icons
    │  │  │  ├─flatpickr
    │  │  │  ├─node-waves
    │  │  │  ├─simplebar
    │  │  │  ├─sweetalert2
    │  │  │  └─toastify
    │  │  ├─modules
    │  │  └─pages
    │  │      ├─admin
    │  │      └─dashboard
    │  └─lang
    └─templates
        ├─error
        ├─html
        │  ├─admin
        │  └─dashboard
        │      └─fragments (화면을 조각으로 나누어 관리)
        └─layouts (모든 페이지의 공통 헤더/푸터/사이드바를 한곳에서 관리)
            ├─admin
            └─basic

• build.gradle 설정

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

group = 'kr.narrator'
def timestamp = java.time.LocalDateTime.now().format(java.time.format.DateTimeFormatter.ofPattern("yyyyMMdd_HHmm"))
version = "0.0.1-${timestamp}"
description = '여러가지 작업을 테스트하는 서비스, 웹프로젝트 백엔드 서버'

java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(25)
	}
}

configurations {
	compileOnly {
		extendsFrom annotationProcessor
	}
}

repositories {
	mavenCentral()
}

dependencies {
	// --- Spring Boot Core ---
	implementation 'org.springframework.boot:spring-boot-starter-web'
	implementation 'org.springframework.boot:spring-boot-starter-webflux' // WebClient 사용을 위해 WebFlux 추가
	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
	implementation 'org.springframework.boot:spring-boot-starter-validation'
	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
	implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect:4.0.0' // 수정한 부분

	// --- Monitoring & Utils ---
	implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310'

	// --- Infrastructure & DB ---
	runtimeOnly 'org.mariadb.jdbc:mariadb-java-client'
	implementation 'org.springframework.boot:spring-boot-starter-data-redis'

	// --- Lombok & MapStruct (순서 중요) ---
	compileOnly 'org.projectlombok:lombok'
	annotationProcessor 'org.projectlombok:lombok'

	// --- DevTools & Test & Spring REST Docs ---
	developmentOnly 'org.springframework.boot:spring-boot-devtools'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

tasks.withType(JavaCompile) {
	options.compilerArgs.add("-parameters")
}

tasks.named('test') {
	useJUnitPlatform()
}

[2026.04.12] gradle 한글 깨짐 현상 수정

• https://gradle.org/releases/ 에서  binary-only 다운로드 (gradle-9.4.1-bin.zip)
• 환경변수 추가 – 변수 이름: GRADLE_USER_HOME, 변수 값: d:\Java\gradle_home.gradle
• Preferences > Gradle 수정 – Local install…: D:\Java\gradle_home, Java home: D:\Java\jdk-25.0.2

// ... (상단 생략)
// --- Java 컴파일 옵션 최적화 ---
tasks.withType(JavaCompile) {
	options.compilerArgs += ["-parameters"]
	options.encoding = 'UTF-8'
}

jacoco {
    toolVersion = "0.8.14"
}

// 1. 공통 제외 대상 정의 (중복 제거 및 유지보수성 향상)
def jacocoExcludes = [
    "**/dto/**",
    "**/entity/**",
    "**/*Application*",
    "**/*MapperImpl*",   // MapStruct
    "**/common/config/**"
]

jacocoTestReport {
    dependsOn test
    reports {
    	xml.required = false
    	html.required = true
    }

    // 2. 리포트 생성 시 클래스 필터링 로직 최적화
	afterEvaluate {
		classDirectories.setFrom(files(classDirectories.files.collect {
			fileTree(dir: it, exclude: jacocoExcludes)
		}))
	}
}

jacocoTestCoverageVerification {
    dependsOn test 

    violationRules {
        rule {
            element = 'BUNDLE'
            limit {
                counter = 'INSTRUCTION'
                value = 'COVEREDRATIO'
                minimum = 0.00 // 현재 0.19이므로 빌드 통과 가능
            }
        }

        rule {
            element = 'CLASS'
            // 3. 변수화한 제외 대상을 그대로 재사용 (실수 방지)
            excludes = jacocoExcludes
            limit {
                counter = 'LINE'
                value = 'COVEREDRATIO'
                minimum = 0.00 // 0.00보다는 아주 낮은 수치라도 설정해두는 것이 좋습니다.
            }
        }
    }
}

tasks.named('test') {
	useJUnitPlatform()
	finalizedBy jacocoTestReport
}

tasks.named('check') {
    dependsOn jacocoTestCoverageVerification // check 실행 시 검증 수행
}