커뮤니티의 연결고리, 1:1 '실시간 쪽지(DM)' 기능 자체 개발 및 아키텍처 설계 여정

👤 인스피

조회 수 17

1. 관계형 데이터베이스(RDBMS) 설계: "누가 지웠는가?"의 딜레마

쪽지 기능 개발에 착수했을 때 가장 먼저 부딪힌 난관은 바로 데이터베이스(DB) 테이블 설계였습니다. 단순히 '보낸 사람', '받는 사람', '내용'만 저장하면 끝날 줄 알았지만, 쪽지라는 시스템 특성상 '삭제'의 주체가 두 명이라는 치명적인 변수가 존재했습니다.

예를 들어, A가 B에게 쪽지를 보냈을 때 A가 보낸 쪽지함에서 해당 쪽지를 삭제하더라도, B의 받은 쪽지함에서는 그 내용이 그대로 보여야 합니다. 반대로 B가 읽고 나서 삭제하더라도 A의 보낸 내역에는 남아있어야 하죠.

이를 해결하기 위해 데이터의 물리적 삭제(DELETE 쿼리)를 즉시 수행하지 않고, 논리적 삭제(Soft Delete) 방식을 도입했습니다. 쪽지 테이블 스키마에 두 개의 Boolean(참/거짓) 컬럼을 추가했습니다.

deleted_by_sender (보낸 사람이 삭제했는가? / 기본값: False)
deleted_by_receiver (받은 사람이 삭제했는가? / 기본값: False)

유저가 삭제 버튼을 누르면 해당 상태값만 True로 업데이트(Update)됩니다. 그리고 두 유저 모두가 삭제 버튼을 눌러 두 컬럼이 모두 True가 되는 순간, 백그라운드 태스크가 이를 감지하여 데이터베이스에서 영구적으로 물리적 삭제를 집행하도록 로직을 구현했습니다. 이 설계를 통해 서버 용량 낭비를 막으면서도 완벽한 1:1 메시지 경험을 제공할 수 있게 되었습니다.

2. N+1 쿼리 문제 극복과 성능 최적화

쪽지 목록을 불러올 때 가장 흔하게 발생하는 백엔드 성능 저하 원인은 바로 'N+1 쿼리 문제'입니다. 받은 쪽지가 20개일 때, 쪽지 데이터를 가져오는 쿼리 1번과, 각 쪽지를 보낸 사람의 닉네임과 프로필 사진을 가져오기 위해 유저 테이블을 조회하는 쿼리 20번이 추가로 발생하여 총 21번의 DB 통신이 일어나는 끔찍한 현상입니다. 트래픽이 몰리면 서버가 뻗어버리는 주범이죠.

저는 FastAPI와 비동기 SQLAlchemy의 강점을 살려 selectinload와 joinedload 같은 Eager Loading(즉시 로딩) 기법을 활용했습니다. 쪽지 리스트를 DB에서 끌어올 때, JOIN 연산을 통해 상대방의 유저 정보까지 단 한 번의 비동기 쿼리로 모두 묶어서 가져오도록 최적화했습니다. 덕분에 페이지 로딩 속도를 기존 대비 70% 이상 단축시키는 쾌거를 이루었습니다.

3. 실시간 알림의 마법: Server-Sent Events (SSE)의 도입

쪽지를 받았을 때, 유저가 새로고침(F5)을 누르기 전까지 쪽지가 온 사실을 모른다면 그것은 '죽은 기능'이나 다름없습니다. 실시간 알림을 구현하기 위해 웹소켓(WebSockets)과 SSE(Server-Sent Events)를 두고 깊은 고민을 했습니다.

결론적으로 저는 SSE(Server-Sent Events) 구조를 채택했습니다. 양방향 통신이 계속 유지되어야 하는 채팅방이라면 웹소켓이 맞겠지만, 쪽지 시스템은 서버가 클라이언트(브라우저)에게 "너에게 새로운 쪽지가 도착했어!"라고 단방향으로 푸시(Push)만 해주면 충분하기 때문입니다. 현재 구축된 Redis Pub/Sub 환경에 SSE 파이프라인을 연결하여, 누군가 쪽지를 전송하면 수신자의 브라우저 우측 하단에 즉각적으로 토스트(Toast) 팝업이 뜨도록 구현했습니다. 서버 자원을 훨씬 적게 먹으면서도 유저에게는 실시간 채팅과 같은 쾌적한 UX를 제공합니다.

4. 보안 철칙: XSS 공격 원천 차단

커뮤니티에서 유저 간 텍스트를 주고받는 기능을 만들 때 개발자가 가장 두려워하는 것은 크로스 사이트 스크립팅(XSS) 공격입니다. 악의적인 유저가 쪽지 내용에 <script> 태그를 몰래 심어서 상대방에게 보내고, 상대방이 쪽지를 여는 순간 세션 쿠키가 탈취당할 수 있는 아주 위험한 취약점입니다.

이를 방어하기 위해 쪽지가 서버로 들어오는 즉시, 백엔드에서 nh3 같은 HTML 살균(Sanitization) 라이브러리를 통해 허용된 안전한 텍스트만 남기고 모든 자바스크립트 태그와 이벤트 핸들러(onclick 등)를 강제로 뜯어내는 과정을 거칩니다. 아무리 정교하게 코드를 꼬아서 쪽지를 보내더라도 서버단에서 완벽하게 세탁되어 순수한 문자열로만 전달되니, 모든 회원님들께서는 안심하고 쪽지 기능을 이용하셔도 좋습니다.

맺으며: 커뮤니티는 계속 진화합니다

이번 실시간 쪽지 기능 업데이트는 단순히 메뉴 하나가 추가된 것을 넘어, 우리 커뮤니티가 정보를 소비하는 '게시판'에서 사람과 사람이 교류하는 '진정한 네트워크'로 한 단계 진화했음을 의미합니다.

이제 유익한 IT 칼럼을 쓴 유저에게 개인적으로 감사를 표하거나, 마음이 맞는 회원들과 소소한 일상을 더 깊게 나눠보세요. 앞으로도 서버 백엔드의 성능을 극한으로 깎고 다듬어, 여러분이 사이트에 머무는 모든 순간이 빠르고 쾌적할 수 있도록 1인 개발자의 밤샘 코딩은 계속됩니다.

새롭게 추가된 쪽지 기능 사용 중 버그나 불편한 점, 혹은 추가되었으면 하는 기능이 있다면 언제든지 피드백 남겨주시길 바랍니다. 감사합니다!