증상
앱 우리집제어에서 조명·난방·가스·환기를 눌러도 기기가 반응하지 않음.
화면에 예상하지 못한 오류가 발생하였습니다. 관리자에게 문의하세요.(SQI9002)가 뜨기도 하고, 아무 메시지 없이 상태만 그대로인 경우도 있음.
먼저 확인
- 설치한 앱이
LH 스마트홈앱이 맞는지 확인할 것. 이름이 비슷한 다른 앱인 경우가 있음. - 월패드 전원이 켜져 있는지 확인할 것.
- 월패드에서 직접 조명·난방을 켜고 끌 수 있는지 확인할 것. 이 답이 조치를 가름.
- 해당 단지가 홈넷 서버 연동이 끝난 단지인지 확인할 것. 연동 전이면 우리집제어 자체가 동작하지 않음.
- 같은 단지의 다른 세대는 제어가 되는지 확인할 것.
- 어떤 기기인지 물을 것. 조명·난방·가스·환기·외출·방범 중 무엇인지에 따라 확인할 곳이 다름.
- 기기 목록은 보이는데 눌러야 안 되는 것인지, 목록 자체가 비어 있는지 구분할 것. 목록이 비어 있으면 기본매뉴얼/입주민/검색된 IoT 기기가 없다고 떠요로 감.
- 가스는 앱에서 잠그기만 됨. 여는 것은 월패드에서만 가능하고 정상 동작임. 외출 모드 카드의 가스 표시가 실제 밸브 상태와 달라 보이는 것도 앱 표시 문제이며 실제 제어와 무관함.
- 외출·방범은 켜기만 됨. 해제는 월패드에서 해야 하고, 둘을 동시에 켤 수는 없음.
- 전입 승인이 끝난 세대인지 확인할 것. 승인 직후에도 앱을 계속 켜 두었다면 앱을 완전히 종료했다 다시 열어야 권한이 새로 반영됨.
- 우리집제어 전체가 로딩만 돌면서 아무것도 안 뜨는지 확인할 것. 이 경우는 세대가 아니라 서버 구간 문제일 가능성이 큼.
- 화면에 뜬 오류 메시지와 실패한 시각(분 단위) 을 받아 둘 것. 스크린샷이 있으면 가장 빠름.
조치
- 월패드에서도 제어가 안 되면 월패드 자체 문제임. 먼저 월패드 전원을 껐다 켜(재부팅) 2~3분 뒤 다시 시도하고, 그래도 안 되면 관리사무소에 월패드 A/S를 신청하도록 안내할 것. 앱 제어는 월패드가 켜져 있을 때만 됨.
- 월패드는 되는데 앱에서만 안 되면, 앱을 완전히 종료한 뒤 다시 열고
우리집제어 > 기기에서 한 번만 누르고 3초 기다릴 것. - 짧은 시간에 여러 번 연속으로 누르지 않도록 안내할 것. 연속 클릭은 서버에 요청이 닿기 전에 앱 단에서 네트워크 오류로 막힘(2026-04-24 부천원종휴튼4단지 사례).
- 에어컨·세탁기 같은 가전은 체험단 세대만 쓸 수 있음. 기본매뉴얼/입주민/에어컨 등 가전 제어가 안 돼요를 안내할 것.
- 위를 모두 해도 안 되면 고객센터(070-7784-1843)로 연결할 것. 단지 홈넷사(코맥스/코콤/현대통신)를 통해 확인해야 하는 경우 시간이 걸린다고 미리 말할 것(2026-02-10 세종조치원역 1블록 코콤 난방·환기 제어 문의 사례).
그래도 안 되면
고객센터에 다음을 전달할 것.
- 단지명, 동호수, 제어하려던 기기(거실 조명1 등)
- 실패한 날짜와 시각(분 단위)
- 앱 버전, 휴대폰 기종
관리자는 관리자 시스템 > 제어 관리 > 기기 제어 현황에서 해당 세대의 성공/실패를 먼저 봄. 로그 확인은 기본매뉴얼/운영/grafana로 로그 보기를 따름.
관리자 확인 순서
- 앱 화면에서 받은 traceId로 로그를 검색함. 그 요청의 서버 처리 과정이 한 번에 나옴. traceId를 못 받았으면 단지·동호수·시각으로 좁힘.
- 로그에서
디바이스 제어 시작→디바이스 제어 성공또는기기 제어 실패 - traceId:를 찾음. - 제어 요청·응답 기록은 제어에 실패해도 남음. 실패 시 응답코드 자리에 홈넷 결과 코드 또는
FAIL이 들어감. 응답코드가2000이면 성공임. - 우리집제어가 전부 로딩만 돈다면
홈넷사 API 호출중 오류 발생또는API Error를 찾음. 이 경우 홈넷 토큰을 받아오는 내부 구간 문제이므로 홈넷사가 아니라 우리 쪽에서 볼 것. 공개노트/기능/홈넷 서버 연동 - 기기 목록은 나오는데 제어만 실패하면
홈넷사 API 처리 실패 - result_code:또는[홈넷사 오류]를 찾음.
홈넷사에 넘기는 기준
앱에서 누른 제어가 우리 서버를 지나 홈넷 서버로 나간 기록이 있으면 우리 쪽 처리는 끝난 것임. 세부 원인은 추적하지 않고 홈넷사에 로그를 전달함.
| 로그에 보이는 것 | 판단 | 다음 행동 |
|---|---|---|
| 제어 요청이 아예 없음 | 요청이 서버까지 오지 않음(연속 클릭·네트워크) | 앱 쪽. 한 번만 누르고 기다리도록 안내 |
홈넷사 API 호출중 오류 발생, API Error만 있음 | 홈넷 토큰을 받는 내부 구간 문제 | 우리 쪽 담당자에게 올림 |
홈넷 서버로 호출이 나가고 ReadTimeoutException 또는 result_code 실패 | 단지 홈넷 구간 문제 | 홈넷사에 전달. 단지명·동호수·시각·요청 내용·결과 코드를 함께 보냄 |
응답코드 2102 | 미전입 세대로 처리됨 | 전입 승인 상태 먼저 확인 |
응답코드 2032·2033 | 게이트웨이·기기 응답 지연 | 홈넷사에 전달 |
| 서버 기록은 전부 성공인데 기기가 안 움직임 | 우리 구간 정상 | 홈넷사에 전달 |
홈넷사를 거치는 건은 회신이 오래 걸림. 접수할 때 시간이 걸린다고 미리 말하고, 진행 상황을 중간에 회신할 것. 회신이 없으면 같은 세대가 반복 접수함.
제어 실패가 몰렸던 단지(2026-06 기준 30일, 실패율 100% 세대 존재): 부천원종휴튼3단지, 고양장항, 청주지북A5, 목포상락, 파주운정3 물향기7단지, 인천검단37단지, 세종조치원역, 김제지평선, 시흥정왕, 인천검단38단지. 2026-09-01 기준으로는 시흥정왕 10,680건 중 2,085건 실패, 과천S11과 평택고덕은 거의 전건 실패였음.
관련
공개노트/기능/우리집제어 공개노트/기능/홈넷 서버 연동 기본매뉴얼/입주민/앱과 월패드가 연동이 안 돼요 기본매뉴얼/입주민/월패드에서는 되는데 앱에서 난방 제어가 안 돼요 기본매뉴얼/입주민/검색된 IoT 기기가 없다고 떠요