How do I debug WebSocket connection issues in production?
Log disconnect reasons (socket.on('disconnect', reason => console.log(reason))). Check Nginx has Upgrade and Connection headers for WebSocket support. Verify HTTPS/WSS is used. Check CORS origin matches the frontend URL. Ensure the auth token is being sent correctly.
Verify This Answer
Cross-check this information using these trusted sources:
More FAQs in Testing and Debugging the Chat Feature Socket.io and Real-Time Messaging
Create test users with JWT tokens, connect Socket.io clients with io() and auth, emit events (join:chat, message:send) and assert received events (message:received) using done callbacks. Test typing indicators, authentication failures, and message persistence. Clean up sockets and server in afterAll.
Check that both sockets joined the same room (log room members with io.sockets.adapter.rooms.get(roomId)). Verify the room ID is the same for both users (check getRoomId function). Ensure the socket didn't disconnect. Check CORS configuration. Verify the event name matches exactly.
You're not cleaning up Socket.io listeners. In React useEffect, return a cleanup function that calls socket.off('message:received', handler) with the specific handler reference. Without cleanup, listeners accumulate on re-renders, causing messages to appear multiple times.
Still have questions?
Browse all our FAQs or reach out to our support team