🎯 RASA Socket.IO 연결 문제 해결기

RASA를 사용하면서 Socket.IO를 통해 실시간 통신을 구현하는 과정에서 예상치 못한 문제에 직면했습니다. 이 글에서는 문제의 증상, 원인 분석, 그리고 해결 방법을 단계별로 정리했습니다.

---

🚩 문제 상황

RASA 서버와 Python Socket.IO 클라이언트를 연결했지만, 클라이언트가 메시지를 보내고 나서도 봇의 응답을 받지 못하는 문제가 발생했습니다.

❗ 주요 증상

• 클라이언트는 정상적으로 서버에 연결됨.
• session_request 이벤트는 잘 전송되고 session_confirm 응답도 정상 수신됨.
• 그러나 user_uttered 이벤트를 전송한 후 서버로부터 아무런 응답이 오지 않음.
• 서버는 내부적으로 봇 응답을 생성했으나, 클라이언트로 전달되지 않음.

---

🔍 원인 분석

RASA의 credentials.yml 파일에서 session_persistence: true로 설정하면, RASA는 Socket.IO의 룸(Room) 기능을 활용하여 세션을 관리합니다.

socketio:
  user_message_evt: user_uttered
  bot_message_evt: bot_uttered
  session_persistence: true

문제는 RASA의 socketio.py 코드에서 enter_room 메서드가 비동기적으로 호출되어 있지만 await가 누락되어 있다는 것이었습니다.

# 문제 코드
sio.enter_room(sid, data["session_id"])  # await가 없음

📚 출처: Rasa Github 이슈

이로 인해 실제로 클라이언트가 해당 룸에 참여하지 못하고, 결국 봇의 응답이 전송되지 않는 현상이 발생했습니다.

---

🛠️ 해결 방법

✅ 1. 임시 해결책: session_persistence 비활성화

credentials.yml 파일에서 session_persistence를 false로 변경하면 문제가 사라집니다.

socketio:
  user_message_evt: user_uttered
  bot_message_evt: bot_uttered
  session_persistence: false

하지만 이 방법은 세션 관리 기능을 포기해야 하므로 근본적인 해결책은 아닙니다.

---

✅ 2. 근본적 해결책: RASA 코드 수정

RASA의 socketio.py 파일을 찾아 enter_room 호출 부분에 await를 추가합니다.

🔎 RASA 코드 위치 찾기

pip show rasa

또는

python -c "import rasa; print(rasa.__file__)"

✏️ 코드 수정

rasa/core/channels/socketio.py 파일을 열어 아래와 같이 수정합니다.

# 수정 전
sio.enter_room(sid, data["session_id"])

# 수정 후
await sio.enter_room(sid, data["session_id"])

수정 후에는 RASA 서버를 재시작해야 변경 사항이 반영됩니다.

rasa run --enable-api --cors "*" --debug --credentials credentials.yml

---

💡 최종 확인

• 클라이언트가 정상적으로 봇의 응답을 수신.
• 세션 관리 기능도 정상적으로 동작.
• 서버와 클라이언트 모두 에러 없이 안정적으로 연결 유지.

---

🚀 마무리

이번 경험을 통해 실시간 통신에서 세션 관리의 중요성과 비동기 프로그래밍의 세세한 부분이 시스템의 안정성에 얼마나 영향을 줄 수 있는지를 배울 수 있었습니다.

혹시 같은 문제를 겪는 분들이 있다면 이 글이 도움이 되길 바랍니다. 🙌