🛠️ 백엔드 개발 환경 설정 A to Z

 

목차

 

 

개발자는 어떻게 서버를 만들고 테스트할까?

 

 

프론트엔드에서 버튼을 누르면 백엔드 서버가 응답을 돌려줍니다.

그런데 이 백엔드 서버는 어디서, 어떻게 동작하고 있을까요?

 

이번 글에서는 백엔드 개발을 시작하기 위해 꼭 알아야 할 서버 환경 구조, 개발 도구 세팅, 로컬 테스트, Git 버전 관리까지

개발 환경 구축 전반을 하나씩 정리해 보겠습니다.

---

🏗️ 서버는 어떻게 구성되어 있을까?

백엔드 개발은 단순히 코드를 짜는 것만으로 끝나지 않습니다.

그 코드가 어디에서, 어떤 구조로 실행되는지 이해하는 것도 매우 중요하죠.

 

웹 서버 vs WAS, 뭐가 다를까?

실제 운영 환경에서는 여러 서버 컴포넌트들이 함께 작동하며 서비스를 제공합니다.

 

웹 서버 (Web Server)

• 역할: 정적 파일(HTML, CSS, JS, 이미지) 제공
• 대표 예시: Apache HTTP Server, Nginx
• 특징: 빠르고 가벼워서 대용량 트래픽 처리에 유리

WAS (Web Application Server)

• 역할: 동적 콘텐츠 처리, 비즈니스 로직 실행
• 대표 예시: Apache Tomcat, JBoss, WebLogic
• 특징: Java 애플리케이션 실행 환경 제공

 실제 구조 흐름

[사용자] → [Nginx (웹서버)] → [Tomcat (WAS)] → [Spring Boot 애플리케이션] → [MySQL DB]

☝️ Nginx는 요청을 전달하고 정적 파일을 캐싱, Tomcat은 Java 기반 애플리케이션을 구동합니다.

---

⚙️ Tomcat은 무엇이고, Spring Boot와 무슨 관계가 있을까?

역할

• WAS(Web Application Server)로, Java 기반의 동적 웹 애플리케이션을 실행
• 사용자의 요청을 받아 Spring 애플리케이션의 컨트롤러를 통해 처리

대표 예시

• Apache Tomcat (가장 널리 사용됨)
• JBoss, Jetty, WebLogic 등

특징

• Java Servlet, JSP 기반 애플리케이션을 실행
• Spring Boot는 내장 Tomcat을 포함하므로 별도 설치 없이 실행 가능

 

💡 코드 예시: Spring Boot 애플리케이션 구동

@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
        // 내장 Tomcat이 자동으로 시작됨 (기본 포트: 8080)
    }
}

Spring Boot 덕분에 java -jar 한 줄로 서버를 구동할 수 있어 개발이 훨씬 간편해졌습니다.

---

📡 Nginx는 백엔드 개발자와 어떤 관계가 있을까?

역할

• 정적 자원을 처리하거나, WAS로 트래픽을 프록시하는 웹 서버(Web Server)
• 고성능 리버스 프록시 및 로드 밸런서로 활용

대표 예시

• Nginx (빠르고 가벼우며 비동기 기반)
• Apache HTTP Server

특징

• 정적 리소스 서빙 (HTML, CSS, JS 등)
• HTTPS 처리, 캐싱, 로드 밸런싱 기능 내장
• 백엔드 서버(Spring Boot)로 프록시 구성 가능

 

💡 설정 예시: Nginx → Spring Boot 프록시

# Nginx 설정 예시
server {
    listen 80;
    server_name example.com;
    
    # 정적 파일 서빙
    location /static/ {
        root /var/www/html;
        expires 1y;
    }
    
    # API 요청을 Spring Boot로 프록시
    location /api/ {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

운영 환경에서는 보통 Nginx를 앞단에 두고, Spring Boot는 API 처리에만 집중하도록 구성합니다.

---

🧰 개발 도구 세팅하기: IntelliJ + Spring Boot

📌 필수 도구

도구	설명
IntelliJ IDEA	Java 개발에 최적화된 IDE
Java JDK 17+	Java 애플리케이션 구동을 위한 런타임
Spring Initializr	프로젝트 생성 도구 (start.spring.io)
Maven/Gradle	빌드 및 의존성 관리 도구

 

💡 Maven vs Gradle 간단 비교

항목	Maven	Gradle
선언 방식	XML	Groovy/Kotlin DSL
속도	다소 느림	빠름 (캐시, 병렬 처리)
가독성	명확하고 직관적	유연하지만 복잡 가능성

입문자라면 Maven부터 시작하는 것이 훨씬 이해하기 쉽습니다.

---

🧪 로컬 개발 서버 실행하고 테스트하기

첫 번째 API 컨트롤러 만들기

@RestController
@RequestMapping("/api")
public class HelloController {
    
    @GetMapping("/hello")
    public ResponseEntity<String> hello() {
        return ResponseEntity.ok("Hello Backend!");
    }
    
    @GetMapping("/health")
    public ResponseEntity<Map<String, Object>> health() {
        Map<String, Object> status = new HashMap<>();
        status.put("status", "UP");
        status.put("timestamp", LocalDateTime.now());
        status.put("port", 8080);
        return ResponseEntity.ok(status);
    }
    
    @PostMapping("/echo")
    public ResponseEntity<Map<String, String>> echo(@RequestBody Map<String, String> request) {
        Map<String, String> response = new HashMap<>();
        response.put("message", "Echo: " + request.get("message"));
        response.put("timestamp", LocalDateTime.now().toString());
        return ResponseEntity.ok(response);
    }
}

 

서버 실행 방법

방법 1: IntelliJ 실행

• Application.java 열기 → 초록 버튼 클릭
• 콘솔에서 Tomcat started on port 8080 확인

방법 2: 터미널 실행 (Maven 기준)

# 터미널에서 프로젝트 루트 디렉토리에서 실행
./mvnw spring-boot:run

# 또는 패키징 후 실행
./mvnw clean package
java -jar target/demo-0.0.1-SNAPSHOT.jar

 

다양한 API 테스트 방법

도구	예시
브라우저	http://localhost:8080/api/hello
curl	curl -X GET http://localhost:8080/api/hello
Postman	GET/POST 요청 시각적으로 테스트 가능
IntelliJ HTTP Client	.http 파일 생성 후 테스트

### GET 요청
GET http://localhost:8080/api/hello
Accept: application/json

### POST 요청
POST http://localhost:8080/api/echo
Content-Type: application/json

{
  "message": "Hello from IntelliJ!"
}

---

🚀  개발 효율을 높이는 팁: Spring Boot DevTools

spring:
  devtools:
    restart:
      enabled: true
    livereload:
      enabled: true

• 코드 변경 시 자동 재시작
• 브라우저 자동 새로고침
• 캐시 자동 비활성화

프론트엔드 개발자에게 핫 리로드가 있다면, 백엔드에겐 DevTools가 있습니다!

---

🔄  Git으로 버전 관리 시작하기

백엔드 프로젝트도 반드시 버전 관리를 해야 합니다.

특히 협업을 하거나 여러 기능을 동시에 개발할 땐 Git이 필수죠.

기본적인 Git 흐름

git init
git add .
git commit -m "Initial commit"

git remote add origin https://github.com/yourname/project.git
git push -u origin main

 

 브랜치 전략 예시

git checkout -b feature/login

브랜치를 기능 단위로 나눠 작업하면 협업 효율도 올라가고, 코드 관리도 훨씬 쉬워집니다.

---

🧡  마무리하며

이번 글에서는 백엔드 개발을 시작하기 위한 환경 설정 전반을 살펴보았습니다.

 

📌  핵심 요약

• 백엔드 구조는 Web Server + WAS + DB로 구성됨
• Spring Boot는 내장 Tomcat 덕분에 실행이 간편
• IntelliJ + Maven/Gradle 조합이 일반적
• DevTools, Git 등 실무에서 사용하는 개발 생산성 도구 익히기
• 다양한 방식으로 API 테스트하며 로직을 점검할 수 있음
• Git을 통해 안정적이고 체계적인 코드 관리가 가능

개발 환경을 제대로 세팅하면 이후의 학습과 실습이 훨씬 수월해집니다.

특히 Spring Boot DevTools와 같은 도구를 활용하면 개발 생산성을 크게 향상시킬 수 있어요.

 

다음 글에서는 Spring 프레임 워크에 대해 알아볼게에요.

궁금한 점이나 환경 설정 과정에서 막히는 부분이 있다면 댓글로 남겨주세요! 🚀