문제 해결
| 증상 | 먼저 확인할 사항 |
|---|---|
ready가 표시되지 않음 | 서버 실행 여부, ws://localhost:7777 주소, WebSocket 포트, 방화벽을 확인합니다. |
| 브라우저에서 연결 실패 | HTTPS 페이지라면 wss:// 연결을 사용하고 서버의 TLS·경로 설정을 확인합니다. |
| 전송했지만 수신하지 못함 | 수신자의 ready, 구독 태그와 송신 태그, 채널·CID 구분을 확인합니다. |
| 번들링 중 Node 모듈 오류 | 브라우저용 iosignal/browser/esm/io.js를 import했는지 확인합니다. |
| 재연결 후 UI가 중복 반응함 | 같은 인스턴스에 핸들러를 반복 등록했는지 확인하고 화면 종료 시 destroy()를 호출합니다. |
| Arduino가 연결되지 않음 | 서버의 congPort 설정과 장치가 사용한 호스트·포트를 확인합니다. |
재현 시 사용한 iosignal 버전, 서버와 클라이언트 실행 명령, 연결 URL(비밀 키 제외), change 및 error 이벤트 출력을 함께 기록하세요.