스프링부트 클론코딩 블로그 프로젝트 Part 1

스프링부트 클론코딩 블로그 프로젝트(cos-blog)를 시작하는 첫 편이다. 본격적인 코딩에 앞서 개발 환경부터 갖춰야 한다. 이 글에서는 JDK 설치와 환경 변수(PATH) 설정, 그리고 데이터베이스로 사용할 MySQL 설치와 MySQL Workbench 연결까지 순서대로 정리한다. 여기까지 마치면 스프링 부트 블로그 개발을 시작할 준비가 끝난다.

이 글은 아래 강좌 영상(겟인데어 스프링부트 블로그 프로젝트 1강)을 참고해 진행했다.

개발 환경

이번 스프링부트 클론코딩 블로그 프로젝트에서 사용하는 개발 환경은 다음과 같다. 강좌 기준 버전을 그대로 따르며, 버전을 통일해야 이후 빌드·실행 단계에서 호환성 문제가 줄어든다.

• OS: Windows(64비트)
• JDK: Java SE 1.8(Java 8)
• 데이터베이스: MySQL 5.7
• 프로젝트 데이터베이스(스키마): cos-blog

JDK 설치와 환경 변수 설정

스프링 부트는 자바 기반 프레임워크이므로, 가장 먼저 JDK(Java Development Kit)를 설치해야 한다. JDK는 자바 애플리케이션을 컴파일하고 실행하는 데 필요한 개발 도구 모음이다. 이 프로젝트에서는 Java SE 1.8(Java 8) 버전을 사용한다.

JDK 1.8 다운로드와 설치

아래 오라클 자바 다운로드 페이지에 접속해 Windows x64용 JDK 1.8 설치 파일을 받는다. 다운로드에는 오라클 계정 로그인이 필요할 수 있다.

https://www.oracle.com/java/technologies/downloads/#java8

받은 설치 프로그램을 실행해 안내에 따라 설치를 완료한다. 기본 설치 경로는 보통 아래와 같으며, 환경 변수 설정에 필요하니 설치 경로를 기억해 둔다.

C:Program FilesJavajdk1.8.0_xxxbin

환경 변수(PATH) 설정

JDK를 설치한 뒤에는 어느 위치에서든 자바 명령어를 쓸 수 있도록 환경 변수를 등록해야 한다. 환경 변수를 등록하지 않으면 명령 프롬프트에서 java나 javac 명령을 찾지 못하므로 반드시 설정한다. 먼저 위에서 확인한 JDK의 bin 폴더 경로를 복사한 뒤, 아래 순서로 등록한다.

1. 내 PC 우클릭 → 속성
2. 고급 시스템 설정 → 환경 변수
3. 시스템 변수에서 Path 더블클릭
4. 새로 만들기 후 복사한 자바 bin 경로를 붙여 넣고 저장

참고로 빌드 도구(Gradle/Maven)나 일부 프로그램은 JAVA_HOME 변수를 함께 참조한다. 시스템 변수에 JAVA_HOME을 JDK 설치 폴더(bin의 상위 경로)로 추가해 두면 더 안정적이다.

# 변수 이름 : JAVA_HOME
# 변수 값   : C:Program FilesJavajdk1.8.0_xxx

# Path 항목에 추가
%JAVA_HOME%bin

저장했으면 새 명령 프롬프트(cmd)를 열어 아래 명령으로 설정이 제대로 됐는지 확인한다. 설치한 버전(1.8.x)이 출력되면 환경 변수 등록이 정상적으로 끝난 것이다.

java -version

# 출력 예시
java version "1.8.0_xxx"
Java(TM) SE Runtime Environment (build 1.8.0_xxx)
Java HotSpot(TM) 64-Bit Server VM

MySQL 5.7 설치

블로그 프로젝트는 게시글·사용자 등의 데이터를 저장할 데이터베이스가 필요하다. 여기서는 MySQL 5.7을 설치한다. MySQL은 가장 널리 쓰이는 오픈소스 관계형 데이터베이스 관리 시스템(RDBMS) 중 하나이며, 스프링 부트의 JPA와도 자연스럽게 연동된다.

인스톨러 다운로드

아래 MySQL 인스톨러 다운로드 페이지에 접속한다. 페이지에는 두 가지 설치 파일이 있는데, 용량이 더 큰 두 번째 링크(약 482MB 전체 설치 패키지)를 받는다. 이 패키지에는 MySQL 서버와 Workbench 등 필요한 구성 요소가 함께 들어 있다.

https://dev.mysql.com/downloads/windows/installer/5.7.html

다운로드 단계에서 오라클 계정 가입을 요구하는 화면이 나오면, 하단의 No thanks, just start my download. 링크를 클릭한다. 로그인 없이 바로 받을 수 있다.

설치와 root 비밀번호·사용자 계정 설정

다운로드한 인스톨러를 실행해 설치 마법사를 따라 진행한다. 설치 과정에서 다음 두 가지를 설정하는 단계가 나온다. 이 값은 이후 스프링 부트의 application.yml(또는 application.properties)에서 DB 접속 정보로 그대로 쓰이므로 잊지 않도록 기록해 둔다.

• root 비밀번호 — MySQL 관리자 계정의 비밀번호. 이후 DB에 접속할 때 사용한다.
• 사용자 계정(Add User) — root 비밀번호 설정 화면 하단의 [Add User]를 클릭해 프로젝트에서 사용할 계정을 추가한다. 사용자 이름과 비밀번호를 입력하고 확인(체크)을 누른다.

설치 도중 지정하는 서비스 이름은 Windows 작업 관리자의 서비스 항목에 표시되는 이름이다. 별도로 바꿀 이유가 없으면 기본값을 그대로 둬도 된다. 이후 단계는 안내에 따라 [Next]를 눌러 진행하고, 마지막 [Finish]까지 마치면 설치가 완료된다.

MySQL Workbench 연결과 DB 생성

설치가 끝나면 MySQL Workbench로 데이터베이스 서버에 접속해 보고, 프로젝트에서 사용할 데이터베이스(스키마)를 생성한다. Workbench는 MySQL을 GUI로 다룰 수 있는 공식 관리 도구다.

새 커넥션 만들기

Workbench를 실행한 뒤, 시작 화면의 MySQL Connections 옆에 있는 더하기(+) 아이콘을 클릭해 새 커넥션을 만든다. 커넥션 정보는 아래와 같이 입력한다.

• Connection Name — 커넥션을 구분할 이름(자유롭게 지정)
• Hostname — 로컬 설치이므로 127.0.0.1
• Port — 기본 3306
• Username — 설치 때 만든 사용자 이름(또는 root)
• Password — Store in Vault…를 눌러 설치 때 설정한 비밀번호 입력

입력을 마치면 [Test Connection]을 클릭해 접속을 확인한다. 연결 성공 메시지가 뜨면 [OK]를 눌러 커넥션을 저장한다.

cos-blog 데이터베이스 생성

커넥션 카드를 더블클릭해 서버에 접속한 뒤, 블로그 프로젝트에서 사용할 데이터베이스(스키마) cos-blog를 생성한다. Workbench 상단의 스키마 생성 아이콘으로 만들거나, 쿼리 창에서 직접 SQL을 실행해도 된다. 한글 데이터를 다룰 것이므로 문자셋은 utf8mb4를 권장한다.

CREATE DATABASE `cos-blog` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

생성한 스키마를 더블클릭해 활성 데이터베이스로 지정하면 환경 구축이 마무리된다. 이 데이터베이스에 이후 게시글·사용자 테이블 등이 JPA를 통해 자동 생성된다.

환경 구축 시 자주 겪는 문제

JDK·MySQL 설치 과정에서 초보자가 자주 막히는 지점과 해결 방법을 정리한다.

• 'java'는 내부/외부 명령이 아닙니다 오류 — PATH에 JDK bin 경로가 등록되지 않았거나, 등록 후 기존 명령 프롬프트를 다시 열지 않은 경우다. 새 cmd 창에서 java -version을 다시 확인한다.
• JDK가 여러 개 설치된 경우 — 의도한 버전(1.8)이 잡히지 않을 수 있다. JAVA_HOME을 명확히 지정하고 Path에서 다른 자바 경로보다 위에 두면 우선 적용된다.
• MySQL 접속 거부(Access denied) — 사용자 이름·비밀번호 오타이거나, 호스트가 localhost/127.0.0.1로 맞지 않은 경우가 대부분이다. 커넥션 정보를 다시 확인한다.
• 포트 3306 충돌 — 다른 MySQL 인스턴스가 이미 3306을 쓰고 있으면 서비스가 뜨지 않는다. 기존 서비스를 종료하거나 포트를 변경한다.

자주 묻는 질문

꼭 Java 8을 써야 하나?

이 강좌는 Java 8(JDK 1.8) 기준으로 진행한다. 강좌와 버전을 맞추면 예제 코드·라이브러리 호환에서 막히는 일이 줄기 때문에, 클론코딩을 따라가는 동안에는 같은 버전을 쓰는 편이 안전하다. 최신 LTS(예: Java 17·21)로 올릴 경우 스프링 부트 버전과 일부 의존성도 함께 맞춰야 한다.

MySQL 대신 MariaDB나 H2를 써도 되나?

가능하다. MariaDB는 MySQL과 호환성이 높아 드라이버·접속 설정만 맞추면 대부분 그대로 동작하고, 간단한 테스트에는 인메모리 DB인 H2도 쓸 수 있다. 다만 이 글은 강좌 기준인 MySQL 5.7로 환경을 구축한다.

root 계정을 그대로 써도 되나?

학습·로컬 환경에서는 무방하지만, 권한이 큰 root를 애플리케이션 접속 계정으로 직접 쓰는 것은 권장하지 않는다. 실습 단계에서도 프로젝트 전용 사용자 계정을 만들어 해당 스키마 권한만 부여하는 습관을 들이면 좋다.

정리 및 다음 단계

여기까지 스프링부트 클론코딩 블로그를 위한 기본 환경을 갖췄다. JDK를 설치하고 환경 변수(PATH·JAVA_HOME)를 등록했으며, MySQL 5.7을 설치하고 사용자 계정과 cos-blog 데이터베이스까지 준비했다. 핵심 순서는 JDK 설치 → 환경 변수 설정 → MySQL 설치 → Workbench 연결 → DB 생성이다.

다음 편에서는 이 환경 위에서 스프링 부트 프로젝트를 생성하고, JPA로 MySQL과 연결해 본격적인 블로그 개발을 시작한다. 자바 개발 환경을 더 다지고 싶다면 같은 카테고리의 다른 개발 글도 함께 참고하면 좋다.