[실습] User Microservice 만들기

JSCODE 박재성

2026. 03. 18.

✅ User Microservice 만들기

✅ Spring Boot 프로젝트 셋팅 & DB 연결

1. Spring Boot 프로젝트 셋팅
start.spring.io
https://start.spring.io/



• Artifact와 Name을 user-service라고 지어주자.
• Package name을 Java 컨벤션에 맞게 userservice라고 지어주자.
• Java 21 버전을 선택하자. 아래 과정을 Java 21 버전을 기준으로 진행할 예정이다.
• Dependencies는 Spring Boot DevTools, Spring Web, MySQL Driver, Spring Data JPA를 선택하자.
 

2. application.yml 작성하기

이 프로젝트에서는 application.properties를 지우고 application.yml을 생성했다.

server:
	port: 8080

spring:
	datasource:
		url: jdbc:mysql://localhost:3306/user-db # DB 주소
		username: root # DB 계정
		password: password # DB 비밀번호
		driver-class-name: com.mysql.cj.jdbc.Driver
	jpa:
		hibernate:
			ddl-auto: update
		show-sql: true

 

3. Spring Boot 서버 실행시켜서 DB 연결 제대로 되는 지 확인하기
Spring Boot 실행시켰을 때 아래와 같은 에러 안 뜨고 서버가 실행되면, 정상적으로 DB가 잘 연결된 것이다.



 

✅ 회원가입 API 만들기

1. User 엔티티 생성하기
domain/User

@Entity
@Table(name = "users")
public class User {

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long userId;

  private String email;

  private String name;

  private String password;

  public User() {
  }

  public User(String email, String name, String password) {
    this.email = email;
    this.name = name;
    this.password = password;
  }

  public Long getUserId() {
    return userId;
  }

  public String getEmail() {
    return email;
  }

  public String getName() {
    return name;
  }

  public String getPassword() {
    return password;
  }
}

 

2. Repository 만들기
domain/UserRepository

public interface UserRepository extends JpaRepository<User, Long> {
}

 

3. Controller 만들기
controller/UserController

@RestController
@RequestMapping("/users")
public class UserController {
  private final UserService userService;

  public UserController(UserService userService) {
    this.userService = userService;
  }

  @PostMapping("sign-up")
  public ResponseEntity<Void> signUp(
      @RequestBody SignUpRequestDto signUpRequestDto
  ) {
    userService.signUp(signUpRequestDto);
    return ResponseEntity.noContent().build();
  }
}

 

4. DTO 만들기
dto/SignUpRequestDto

public class SignUpRequestDto {
  private String email;
  private String name;
  private String password;

  public String getEmail() {
    return email;
  }

  public String getName() {
    return name;
  }

  public String getPassword() {
    return password;
  }
}

 

5. Service 만들기
service/UserService

@Service
public class UserService {
  private final UserRepository userRepository;

  public UserService(UserRepository userRepository) {
    this.userRepository = userRepository;
  }

	@Transactional
  public void signUp(SignUpRequestDto signUpRequestDto) {
    User user = new User(
      signUpRequestDto.getEmail(),
      signUpRequestDto.getName(),
      signUpRequestDto.getPassword()
    );

    this.userRepository.save(user);
  }
}

 

6. 서버 다시 실행시키기



 

7. API 잘 작동하는 지 테스트해보기

7. DB에 데이터 잘 들어갔는 지 확인하기