메일 동기화 SSE 연결 500 오류 수정

[donghyuck]

Type

• Bug
• Feature
• Refactor
• Docs
• Chore

Size

• Small (1): 단순 수정 / 단일 파일
• Medium (2): 기능 단위 변경 / 다중 파일
• Large (3): 구조 변경 / 복수 모듈

Summary

• 메일 동기화 화면에서 SSE 연결이 500 응답으로 실패하여 동기화 상태를 받을 수 없습니다.

Background

• 프론트엔드 /application/mail/sync 진입 시 메일 동기화 SSE 연결에 실패했습니다. 오류가 표시됩니다.
• 브라우저 콘솔에는 EventSource's response has a status 500 that is not 200. Aborting the connection. 로그가 출력됩니다.
• 클라이언트는 SSE 실패 콜백에서 오류를 표시하고 있으며, 실제 실패 원인은 서버 SSE 엔드포인트 응답 500으로 보입니다.

Scope

• 메일 동기화 SSE 엔드포인트가 인증된 사용자 요청에서 200 text/event-stream 응답을 안정적으로 반환하도록 수정합니다.
• SSE 초기 연결, 예외 처리, 인증 컨텍스트, 응답 commit 이후 예외 처리 흐름을 확인합니다.
• 프론트엔드 변경은 이번 이슈 범위에 포함하지 않습니다.

Acceptance Criteria

• /application/mail/sync 진입 시 SSE 연결 실패 alert가 표시되지 않습니다.
• 브라우저 콘솔에 EventSource's response has a status 500 오류가 남지 않습니다.
• 인증된 사용자의 메일 동기화 이벤트 스트림이 정상 연결됩니다.
• 서버 로그에 response committed 이후 보안/예외 처리 오류가 남지 않습니다.

Validation Plan

• build
• test
• smoke / manual check
• analysis only (no code change)

AI-Assisted

• Yes
• No

AI Usage

• Usage type: 브라우저 메뉴 스모크 테스트와 결함 분석 지원
• Subagent used: No
• Delegated scope: 없음
• Main author validation: /application/mail/sync 수동 진입 후 SSE 연결 상태와 브라우저 콘솔, 서버 로그 확인

Notes

• 확인 URL: http://localhost:3000/application/mail/sync
• 관측 로그: EventSource's response has a status 500 that is not 200. Aborting the connection.

[donghyuck]

이슈 재검토 결과, 원인은 studio.features.mail.web.notify=stomp 설정에서 SSE 컨트롤러가 등록되지 않아 /api/mgmt/mail/sync/stream 요청이 static resource fallback으로 처리되고 500으로 포장되는 흐름으로 확인했습니다.

조치 PR: #377

반영 내용:

• notify 전송 채널과 sse endpoint 노출 조건을 분리했습니다.
• notify=stomp이어도 studio.features.mail.web.sse=false가 아니면 /sync/stream을 노출합니다.
• SSE 연결 직후 connected 이벤트를 전송해 HTTP 200 text/event-stream이 안정적으로 열리도록 했습니다.
• SSE/STOMP notifier 동시 사용 시 한 notifier 실패가 다른 notifier 전송을 막지 않도록 composite notifier를 추가했습니다.

검증:

• ./gradlew :starter:studio-application-starter-mail:test :studio-application-modules:mail-service:test 성공
• git diff --cached --check 성공
• 인증 토큰으로 /api/mgmt/mail/sync/stream 호출 시 HTTP/1.1 200, Content-Type: text/event-stream, event:connected 수신 확인
• PR gitleaks check 통과

Acceptance 기준 중 서버 측 500 제거와 인증 사용자 stream 연결은 충족했습니다. 브라우저 화면 alert 제거는 PR 병합 후 프론트 dev 환경에서 최종 확인하면 됩니다.

[donghyuck]

PR #377 병합으로 서버 측 SSE 500 수정이 반영되어 이슈를 닫습니다. 검증 기준: 인증 요청이 으로 연결되고 이벤트를 반환합니다.