백엔드 스터디 Day 7: 테스트 코드로 AI 백엔드 검증하기

이 API는 게시글을 만든다.
이 API는 제목이 비어 있으면 400을 돌려준다.
이 API는 본인 게시글만 수정할 수 있다.

제목과 내용을 보내면 게시글이 저장되는가?
제목이 비어 있으면 400 Bad Request가 나오는가?
다른 사용자의 게시글을 수정하려 하면 403 Forbidden이 나오는가?

테스트 없음: 코드가 그럴듯해 보인다
테스트 있음: 이 입력에서는 이 결과가 나와야 한다는 증거가 있다
좋은 테스트 있음: 정상/실패/권한/경계 케이스까지 안전망이 있다

src/
  main/
    java/com/example/app/
      post/
        PostController.java
        PostService.java
        PostRepository.java
        Post.java
  test/
    java/com/example/app/
      post/
        PostControllerTest.java
        PostServiceTest.java
        PostRepositoryTest.java

PostControllerTest   -> API 요청/응답을 주로 확인
PostServiceTest      -> 비즈니스 규칙을 주로 확인
PostRepositoryTest   -> DB 저장/조회 쿼리를 주로 확인
AuthServiceTest      -> 로그인/토큰/비밀번호 검증 흐름을 주로 확인

src/main/java/.../post/PostController.java
src/main/java/.../post/PostService.java
src/main/java/.../post/PostRepository.java
src/main/java/.../auth/AuthController.java
src/main/java/.../auth/AuthService.java
src/main/java/.../security/JwtTokenProvider.java

src/test/java/.../post/PostControllerTest.java

given: 이런 상황이 준비되어 있고
when: 이 행동을 실행하면
then: 이런 결과가 나와야 한다

@ExtendWith(MockitoExtension.class)
class PostServiceTest {

    @Mock
    private PostRepository postRepository;

    @InjectMocks
    private PostService postService;

    @Test
    void createPost_savesPostAndReturnsId() {
        // given
        CreatePostRequest request = new CreatePostRequest("제목", "내용");
        User author = new User(1L, "jin@example.com", "진규");
        Post savedPost = new Post(10L   author

given: 제목/내용 요청과 작성자, 저장 결과를 준비한다
when: postService.createPost를 실행한다
then: 응답 id/title이 맞고 repository.save가 호출됐는지 확인한다

POST /api/posts
Authorization: Bearer ***
Content-Type: application/json

{
  "title": "첫 글",
  "content": "내용"
}

201 Created

{
  "id": 10,
  "title": "첫 글"
}

@WebMvcTest(PostController.class)
class PostControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private PostService postService;

    @Test
    void createPost_returnsCreatedResponse() throws Exception {
        // given
        CreatePostResponse response = new CreatePostResponse(10L, "첫 글");
        given(postService.createPost(any(), any())).willReturn(response

요청 경로: POST /api/posts
요청 헤더: Authorization, Content-Type
요청 body: title, content
응답 상태: 201 Created
응답 body: id, title

.andExpect(status().isOk());

.andExpect(jsonPath("$.id").value(10))
.andExpect(jsonPath("$.title").value("첫 글"));

@Test
void createPost_withBlankTitle_returnsBadRequest() throws Exception {
    mockMvc.perform(post("/api/posts")
                    .contentType(MediaType.APPLICATION_JSON)
                    .content("""
                        {
                          "title": "",
                          "content": "내용"
                        }
                        """))
            .andExpect(status().isBadRequest())
            .andExpect(jsonPath("$.message").

@Test
void createPost_withoutToken_returnsUnauthorized() throws Exception {
    mockMvc.perform(post("/api/posts")
                    .contentType(MediaType.APPLICATION_JSON)
                    .content("""
                        {
                          "title": "첫 글",
                          "content": "내용"
                        }
                        """))
            .andExpect(status().isUnauthorized());
}

게시글 작성자 본인만 게시글을 수정할 수 있다.

@Service
@RequiredArgsConstructor
public class PostService {

    private final PostRepository postRepository;

    @Transactional
    public UpdatePostResponse updatePost(Long postId, UpdatePostRequest request, User currentUser) {
        Post post = postRepository.findById(postId)
                .orElseThrow(() -> new NotFoundException("게시글을 찾을 수 없습니다."));

        if (!post.isAuthor(currentUser)) {
            throw new ForbiddenException

@Test
void updatePost_whenCurrentUserIsNotAuthor_throwsForbidden() {
    // given
    User author = new User(1L, "author@example.com", "작성자");
    User otherUser = new User(2L, "other@example.com", "다른 사용자");
    Post post = new Post(10L, "기존 제목", "기존 내용", author);
    UpdatePostRequest request = new UpdatePostRequest("새 제목", "새 내용");

    given(postRepository.findById(post

작성자가 아닌 사용자가 게시글을 수정하려 하면 ForbiddenException이 발생해야 한다.

- 정상 케이스만 있는가?
- 찾을 수 없는 데이터 케이스가 있는가?
- 권한이 없는 사용자 케이스가 있는가?
- 중복/상태 전이/수량 제한 같은 비즈니스 규칙이 있는가?
- 예외 메시지나 예외 타입이 API 에러 응답과 연결되는가?

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
    boolean existsByEmail(String email);
}

@DataJpaTest
class UserRepositoryTest {

    @Autowired
    private UserRepository userRepository;

    @Test
    void findByEmail_returnsUser() {
        // given
        User user = new User("jin@example.com", "진규");
        userRepository.save(user);

        // when
        Optional<User> found = userRepository.findByEmail("jin@example.com");

        // then
        assertThat(found).isPresent()

- 저장 후 조회가 되는가?
- unique 제약조건이 필요한 필드가 실제로 중복을 막는가?
- 연관관계가 의도대로 저장/조회되는가?
- 삭제나 soft delete 조건이 쿼리에 반영되는가?
- 정렬/페이징 조건이 맞는가?

@Column(nullable = false, unique = true)
private String email;

@Test
void save_whenEmailDuplicated_throwsException() {
    userRepository.save(new User("jin@example.com", "진규"));
    userRepository.flush();

    userRepository.save(new User("jin@example.com", "다른 이름"));

    assertThatThrownBy(() -> userRepository.flush())
            .isInstanceOf(DataIntegrityViolationException.class);
}

@Mock
private PostRepository postRepository;

@InjectMocks
private PostService postService;

given(postRepository.findById(10L)).willReturn(Optional.of(post));

테스트 중 postRepository.findById(10L)을 호출하면, 실제 DB를 보지 말고 이 post를 찾은 것처럼 행동해라.

Repository 테스트: DB 저장/조회가 맞는지 확인
Service 테스트: DB가 이런 값을 돌려줬을 때 비즈니스 규칙이 맞는지 확인
Controller 테스트: Service가 이런 값을 돌려줬을 때 HTTP 응답이 맞는지 확인

단위 테스트: 특정 클래스의 규칙을 빠르게 확인
슬라이스 테스트: Controller 또는 Repository 같은 한 층을 확인
통합 테스트: 실제 Spring context와 DB에 가까운 흐름을 확인

@SpringBootTest
@AutoConfigureMockMvc
class PostIntegrationTest {

    @Autowired
    private MockMvc mockMvc;

    @Autowired
    private PostRepository postRepository;

    @Test
    void createPost_persistsPost() throws Exception {
        mockMvc.perform(post("/api/posts")
                        .header("Authorization", "Bearer ***")
                        .contentType(MediaType.APPLICATION_JSON)
                        .content("""
                            {

HTTP 요청 -> Controller -> Service -> Repository -> DB

- 보안 필터와 Controller가 함께 작동하는지
- JSON 직렬화/역직렬화가 실제로 맞는지
- DB 제약조건과 트랜잭션이 실제로 작동하는지
- 에러 응답 포맷이 실제 요청에서 일관적인지

@Test
void updatePost_whenCurrentUserIsAuthor_updatesPost() {
}

@Test
void updatePost_whenCurrentUserIsNotAuthor_throwsForbidden() {
}

@Test
void createPost_whenTitleIsBlank_returnsBadRequest() {
}

@Test
void test1() {
}

@Test
void createPostTest() {
}

@Test
void success() {
}

- 게시글 작성자는 게시글을 수정할 수 있다
- 작성자가 아닌 사용자는 게시글을 수정할 수 없다
- 제목이 비어 있으면 게시글을 만들 수 없다
- 존재하지 않는 게시글은 404를 반환한다
- 인증되지 않은 사용자는 게시글을 만들 수 없다

@Test
void createPost_callsRepositorySave() {
    postService.createPost(request, user);
    verify(postRepository).save(any(Post.class));
}

ArgumentCaptor<Post> captor = ArgumentCaptor.forClass(Post.class);

postService.createPost(request, user);

verify(postRepository).save(captor.capture());
Post saved = captor.getValue();
assertThat(saved.getTitle()).isEqualTo("제목");
assertThat(saved.getContent()).isEqualTo

@Test
void loginTest() {
    LoginResponse response = authService.login(request);
    assertThat(response).isNotNull();
}

- 이메일/비밀번호가 맞으면 accessToken이 발급되는가?
- 비밀번호가 틀리면 Unauthorized가 발생하는가?
- 존재하지 않는 이메일이면 Unauthorized가 발생하는가?
- 응답에 필요한 사용자 요약 정보가 들어있는가?
- 비밀번호 원문이 응답에 포함되지 않는가?

- 게시글이 존재하지 않음
- 현재 사용자가 작성자가 아님
- 제목이 비어 있음
- 인증 정보가 없음

- 이메일 형식이 잘못됨
- 비밀번호가 너무 짧음
- 이미 가입된 이메일
- 닉네임이 비어 있음

GET /api/users/me        -> 로그인 사용자만 가능
PATCH /api/posts/{id}    -> 작성자만 가능
DELETE /api/posts/{id}   -> 작성자 또는 관리자만 가능
GET /api/admin/users     -> 관리자만 가능

./gradlew test

./mvnw test

BUILD SUCCESSFUL
42 tests completed

PostServiceTest > updatePost_whenCurrentUserIsNotAuthor_throwsForbidden FAILED
Expected ForbiddenException but was NotFoundException

1. 테스트의 given 데이터가 잘못되어 게시글을 찾지 못했다
2. 구현이 권한 확인 전에 잘못된 조회/조건을 사용하고 있다

1. 정상 흐름 테스트가 있는가?
2. 실패 흐름 테스트가 있는가?
3. 권한/인증 테스트가 있는가?
4. DB 제약조건 테스트가 있는가?
5. 프론트엔드와 맞춰야 하는 JSON 필드 테스트가 있는가?
6. 테스트 이름이 요구사항을 설명하는가?
7. 테스트가 너무 약한 assertThat(response).isNotNull() 수준은 아닌가?
8. 실제 CI/build에서 실행되는 테스트인가?

PostServiceSpec.java      -> 설정에 따라 실행되지 않을 수 있음
PostServiceTest.java      -> 보통 테스트로 인식됨

@Disabled("나중에 수정")
@Test
void updatePost_whenCurrentUserIsNotAuthor_throwsForbidden() {
}

게시글 생성/수정/삭제 API를 만들어줘.
그리고 아래 테스트를 포함해줘.

1. Controller 테스트
   - 정상 생성 시 201과 id/title 응답
   - title이 비어 있으면 400
   - 인증 토큰이 없으면 401

2. Service 테스트
   - 작성자 본인은 수정 가능
   - 작성자가 아니면 ForbiddenException
   - 존재하지 않는 게시글이면 NotFoundException

3. Repository 테스트
   - 작성자별 게시글 목록 조회
   - 최신순 정렬

테스트 이름은 요구사항 문장처럼 작성해줘.
단순 not-null 검증만 하지 말고 중요한 필드와 예외를 검증해줘.

로그인/회원가입 기능을 만들고 테스트를 포함해줘.

- 회원가입: 이메일 중복이면 실패
- 회원가입: 비밀번호가 너무 짧으면 400
- 로그인: 올바른 이메일/비밀번호면 accessToken 반환
- 로그인: 비밀번호가 틀리면 401
- 로그인 응답에는 password/passwordHash가 포함되지 않음
- 보호된 API는 토큰 없이는 401
- 다른 사용자의 리소스 수정은 403

1. src/test가 있는지 본다.
2. 기능별 테스트 파일이 실제 코드와 짝을 이루는지 본다.
3. 테스트 이름을 요구사항 목록처럼 읽는다.
4. 각 테스트를 given / when / then으로 번역한다.
5. 정상 케이스뿐 아니라 실패/권한/검증 케이스가 있는지 본다.
6. Controller 테스트에서 상태 코드와 JSON 필드를 확인하는지 본다.
7. Service 테스트에서 비즈니스 규칙과 예외를 확인하는지 본다.
8. Repository 테스트에서 DB 제약조건과 쿼리를 확인하는지 본다.
9. Mock이 무엇을 가짜로 대체하는지 확인한다.
10. 실제 테스트 명령이 통과했는지 확인한다.

테스트 구조
- src/test가 있는가?
- Controller/Service/Repository 테스트가 적절히 나뉘어 있는가?
- 테스트 이름이 요구사항을 설명하는가?

Controller 테스트
- HTTP method/path가 실제 API 계약과 맞는가?
- 요청 body와 header를 검증하는가?
- status code뿐 아니라 JSON 응답 필드도 검증하는가?
- 입력 검증 실패와 인증 실패 케이스가 있는가?

Service 테스트
- 정상 흐름만이 아니라 실패 흐름이 있는가?
- 권한 규칙을 테스트하는가?
- 예외 타입과 메시지가 기대와 맞는가?
- Repository 저장/조회 결과에 따라 비즈니스 규칙이 맞게 동작하는가?

Repository 테스트
- 실제 DB에 가까운 테스트가 있는가?
- unique, nullable, 연관관계, 정렬, 페이징 조건을 검증하는가?

AI 코드 위험 신호
- assertThat(response).isNotNull()만 있는가?
- @Disabled 테스트가 많은가?
- 보안/권한 테스트가 빠져 있는가?
- 프론트엔드가 의존하는 JSON 필드를 확인하지 않는가?
- 테스트가 실제 빌드/CI에서 실행되는가?

이 입력에서
이 행동을 하면
이 결과가 나와야 한다