🚀 Java 25 & STS 5.1.0 업그레이드: 차세대 스프링 부트 환경 구축기

2026년 03월 17일

Last Updated: 2026년 03월 17일

기존 sts-4.27.0에서 최신 sts-5.1.0으로 업그레이드하며, Java 25(Early Access/Modern JDK) 기반의 개발 환경을 세팅한 과정을 기록합니다. 다른 추가사항은 생각나면…

0. 시스템 환경 변수 점검

가장 먼저 OS 레벨의 환경 변수가 올바르게 설정되어 있는지 확인합니다. (Java 25 사용을 위해 JAVA_HOME 경로는 상황에 따라 업데이트가 필요합니다.)

JAVA_HOME: D:\Java\jdk-21.0.6 (추후 25 정식 적용 시 변경)
GRADLE_HOME: D:\Java\gradle_home
MYSQL_HOME: D:\Java\MariaDB 11.7
Path: %JAVA_HOME%\bin, %GRADLE_HOME%\bin, %NODE_HOME% 등

1. 기존 개발 환경 기록 (Pre-check)

업그레이드 전, 기존 IDE(Preferences)의 주요 설정 값을 메모해둡니다.

Gradle: Local Installation (D:\Java\gradle_home)
Java: Compiler compliance level (21)
JREs: Installed JREs 확인

2. 새 버전 다운로드 및 설치

Spring 공식 사이트에서 최신 버전을 다운로드합니다.

다운로드: spring.io/tools#eclipse
변경 사항: sts-4.27.0.RELEASE ➔ sts-5.1.0.RELEASE

3. 워크스페이스(Workspace) 초기화

기존 워크스페이스와의 충돌을 방지하기 위해 폴더명을 변경하고 새로 생성합니다.

기존: workspace ➔ workspace_260317 (백업)
신규: workspace 폴더 생성
참고: 기존 workspace 폴더는 그대로 두고 workspace_sts-5.1.0 으로 해도 됨.

4. 신규 프로젝트 생성 (New Spring Starter Project)

STS 5.1.0을 실행하고 Java 25 기반의 프로젝트를 생성합니다.

Type: Gradle – Groovy
Java Version: 25 (Project Loom 가상 스레드 활용 가능)
Artifact/Group: demo / kr.narrator
Dependencies: Web, JPA, MariaDB, Lombok, Validation, Thymeleaf 등

5. IDE 개인 설정 (UI/UX)

가장 먼저 눈의 편안함을 위해 폰트를 설정합니다.

General > Appearance > Colors and Fonts > Basic > Text Font

6. 프로젝트 설정 최적화 (핵심 포인트!)

최신 버전과 Java 25에 최적화된 설정 작업을 진행합니다.

📁 .env 파일 생성

보안 및 환경 관리를 위해 프로젝트 최상위 루트에 .env 파일을 생성하고 DB 정보 등을 담습니다.

📁 application.yml 작성

application.properties를 YAML로 변환 후, 가상 스레드(Virtual Threads) 설정을 추가합니다.

spring:
  application:
    name: demo
  profiles:
    active: local # 운영 시 'prod'로 변경
    include:
      - datasource
  config:
    import: optional:file:.env[.properties] # .env import
  # Java 21 이상(Java 25 포함) 핵심 설정: 가상 스레드 활성화
  threads:
    virtual:
      enabled: true

#############################################
# Server
server:
  port: ${SERVER_PORT:9090}
  shutdown: graceful # 종료 시 진행 중인 요청을 안전하게 처리 (Java 25 가상 스레드 정리 포함)
  tomcat:
    max-connections: 2000 # 스레드 개수가 아닌 최대 동시 연결 수 제어

📁 application-datasource.yml 작성

가상 스레드 환경에서는 기존의 max-threads 설정 대신 효율적인 커넥션 풀 관리가 중요합니다. (속성명 경고 방지를 위해 하이픈 방식 권장)

spring:
  config:
    activate:
      on-profile: "datasource"

  datasource:
    driver-class-name: org.mariadb.jdbc.Driver
    url: jdbc:mariadb://${DB_HOST}:${DB_PORT}/${DB_NAME}?serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true
    username: ${DB_USER}
    password: ${DB_PASSWORD}
    hikari:
      pool-name: NarratorHikariCP
      maximum-pool-size: 10
      minimum-idle: 5
      idle-timeout: 30000
      max-lifetime: 1800000
      connection-timeout: 20000

  jpa:
    hibernate:
      ddl-auto: update # 또는 validate, none, create 등
    show-sql: false
    properties:
      hibernate:
        format-sql: false
        use-sql-comments: false
        highlight-sql: true
    open-in-view: false

7. 테스트 코드 작성

🟢 IndexController.java

package kr.narrator.demo;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringBootVersion;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class IndexController {

	@Value("${spring.application.name}")
	private String appName;

	@GetMapping("/") // "/" 경로로 접속하면 index.html을 보여줍니다.
	public String index(Model model) {
		model.addAttribute("appName", appName);
		model.addAttribute("javaVersion", System.getProperty("java.version"));
		model.addAttribute("springBootVersion", SpringBootVersion.getVersion());
		return "index"; // templates/index.html 파일을 찾습니다.
	}
}

🔵 index.html (Thymeleaf)

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org" lang="ko">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Java 25 + Spring Boot 3.4 데모</title>
    <style>
        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            display: flex;
            justify-content: center;
            align-items: center;
            height: 100vh;
            margin: 0;
            background-color: #f4f7f6;
        }
        .container {
            text-align: center;
            background: white;
            padding: 2rem 3rem;
            border-radius: 10px;
            box-shadow: 0 4px 6px rgba(0,0,0,0.1);
        }
        h1 {
            color: #2c3e50;
        }
        p {
            color: #7f8c8d;
            font-size: 1.1rem;
        }
        .highlight {
            color: #27ae60;
            font-weight: bold;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>서버 실행 성공! 🚀</h1>
        <p>프로젝트 이름: <span class="highlight" th:text="${appName}">demo</span></p>
        <p>Java 버전: <span class="highlight" th:text="${javaVersion}">25</span></p>
        <p>Spring Boot 버전: <span class="highlight" th:text="${springBootVersion}">3.4.1</span></p>
        <p>가상 스레드(Loom): <span class="highlight">활성화됨 ✅</span></p>
    </div>
</body>
</html>

8. 최종 결과 확인

서버를 기동하고 브라우저에서 접속합니다.

URL: http://localhost:9090/

성공! 이제 Java 25의 강력한 성능과 STS 5.1.0의 쾌적한 환경에서 개발을 시작할 수 있습니다. 🚀

💡 꿀팁: STS 5.x 버전부터는 YAML 에디터의 검사가 엄격해졌습니다. [format_sql] 처럼 대괄호를 쓰거나 format-sql처럼 하이픈 형식을 사용하면 경고를 지울 수 있습니다!

[2026.03.17] lombok 문제 해결

sts 설치 폴더에 lombok.jar 파일을 복사한다.
SpringToolsForEclipse.ini 하단에 -javaagent:D:\path\to\lombok.jar 를 추가한다.
sts 를 실행 후 Project > Clean 을 클릭한다.

Tags: Java25 spring Spring Boot SpringBoot3.4 SpringTools5 VirtualThreads 스프링부트