[Vue3 + Spring Boot] 2. Spring Boot 환경 설정

1. 프론트엔드로 레이아웃 구현하기: https://minjh1126.tistory.com/71

[Vue3 + Spring Boot] 1. Todo 레이아웃 만들기

 

 

 

 

 프론트엔드의 기본적인 구성이 끝났으니, 이제 본격적인 구현을 위해 백엔드의 환경을 설정해 줄 차례입니다. 줄곧 프론트엔드만 했던 사람으로서 백엔드 환경설정에 어려움을 겪긴 했습니다. npm / npx install 만 하면 모두 구현 가능했는데... 생각보다 백엔드는 환경설정이 중요한 것 같더라고요. 그래도 Spring Boot의 경우에는 그나마 기본적으로 제공해 주는 게 있어 설정이 쉬웠던 것 같습니다.

 

1. Spring Boot?

 개인적으로 느끼기에는, 한국에서 가장 많이 사용되는 백엔드 프레임워크인 것 같습니다. 특히 Java로 백엔드를 개발한다면 무조건적으로 사용하게 되는 프레임워크입니다. 제 주변 백엔드 분들도 거진 100% 자바 + 스프링을 사용하셨습니다. 게다가 프론트에게 너 React 써? 아니면 무슨 언어 써? 하는 질문이 백엔드에게는 자프링이야 코프링이야? 하는 질문인 것 같더라고요. 그만큼 현재로서는 백엔드에 가장 많이 사용되는 프레임워크 중 하나라는 생각입니다. 

 

 스프링부트의 특징 중 하나는 POJO(Plain Old Java Object)입니다. 간단히 말해 옛날 자바 방식을 사용한다는 뜻입니다. 즉, 다른 라이브러리나 기술을 사용하지 않습니다. 그래서 어떤 라이브러리에 변화 같은 게 있더라도 의존하고 있지 않으니 영향이 없습니다. 하지만 정말 자바로만 모든 걸 프로그래머가 관리해야 한다고 하면 불편할 겁니다. 그러면 백엔드 프로그래머들이 스프링을 사용하지 않겠죠. 이런 사태를 방지하기 위해 POJO를 지원하는 기술( IoC/DI, AOP, PSA )들이 있습니다. 

 

 

2. 환경 설정 

 

 이제 Todo List의 구현을 위해 백엔드 환경을 설정해보겠습니다. Spring Boot을 사용할 때는 직접 하나하나 설정해 줄 수도 있지만, 스프링에서 이 기능을 제공해 줍니다. Spring initializr이라 불리기도 합니다.

https://start.spring.io/

 

저는 2025년 2월 3일 기준으로 

 

 이런 화면이 뜹니다. 차례대로 어떤 항목이냐 하면

1. Project: 빌드 툴. 옛날에는 Maven이 많이 사용됐지만 요즘은 거의다 Gradle을 사용한다. 버전에 맞는 Gradle이 깔려있어야 오류가 안 난다.

2. Language: 어떤 언어를 사용할 지 선택한다.

3. Spring Boot: 스프링부트의 버전. 괄호 안에 SNAPSHOT 등 무언가 적혀있으면 아직 테스트 중인 버전이다. 그래서 괄호가 없는 버전 중 가장 최신을 선택하면 가장 안전하다.

4. Project Metada: 프로젝트의 메타 데이터. 이름 등을 설정한다.

5. Dependencies: 함께 넣을 라이브러리들을 설정한다. 나는 Spring Web을 함께 넣어줬다.

 

= 웬만해서는 디폴트로 다운 받는 게 제일 안전하다...

 

이런 요소들을 설정 후 Generate을 눌러주면 환경 설정을 위한 .zip 파일이 다운로드됩니다. 그걸 개발하고자 하는 파일에 압축을 풀어주면 일차적인 설정이 완료됩니다.

 

 

3. 실행하기

 

 프론트엔드는 VSCode를 사용하지만, 백엔드들은 대다수 IntelliJ를 사용하는 것 같습니다. 그래서 한 번 IntelliJ로 사용해 보도록 하겠습니다.

 

 우선 처음으로 설정했을 때에는 gradle 설정이 되어있지 않을 겁니다. 처음에 한 번 하면 끝나는 거라... 어떻게 했는지 까먹었는데, 저도 계속 오류가 나서 chat gpt에게 물어본 기억이 있습니다. 혹시 설정이 안 되어있을 때는 chat gpt에게 여쭤보시면 쉽게 해결하실 수 있습니다. 그래도 헤매실 가능성이 있어서 (제가 그랬음) 제 삽질했던 것들을 올려드립니다.

 

1. 파일들이 빨간색이에요!: git 연동을 하셔서 그렇습니다. 아직 브랜치에 등록되지 않은 파일은 빨간색으로 뜨는 것 같습니다.

2. 처음 실행은 되는데 80%에서 멈춰요!: 그때 실행하셔도 됩니다. localhost:8080으로 접속하시면 잘 될 겁니다.

3. 그 외... : 많은 오류들이 있었는데 대체로 gradle-spring, java-spring 연동 오류 같았습니다. 모두 호환되는 버전인지 확인해 주세요. SDK에서 자바 버전이 확인 가능한데, Initializer에서 설정한 자바 버전과 맞는지 확인해 주세요.

 

src/main/java/com.example.이름/이름Application 의 main을 실행하시면 터미널에

 

 

Spring 로고와 Started 어쩌구저쩌구... 가 뜨면 실행 성공입니다. 이 상태에서 localhost:8080에 접속하면 

 

 이런 페이지가 뜹니다. 오류라고는 하지만... 띄워줄 화면을 설정해두지 않아서 생기는 오류입니다. 어쨌든 백엔드 서버는 잘 돌아간다는 증거이니, 환경 설정은 성공입니다! 

 

이후에는 백엔드 컨트롤러 등 CRUD를 구현하고, 프론트엔드에서 CRUD를 구현하는 방식으로 진행될 것 같습니다.