개발 취재 노트
Windows 로컬 웹앱에서 WiFi QR 자동 입력값이 null로 나올 때 확인할 순서
완성 코드가 아니라 null의 원인을 가르는 진단 순서를 적은 글이다. 휴대폰으로 접속하는 뷰어·리더 페이지를 가진 로컬 웹앱(formation)의 서버 화면에서, Windows PC의 Node 서버가 현재 WiFi 이름과 비밀번호를 읽어 접속용 QR 입력칸을 채우게 하려 했다. 첫 검증에서 /wifi 응답은 null이었다.
결론
null이면 코드를 의심하기 전에, 서버를 돌리는 PC가 그 순간 WiFi에 연결돼 있는지부터 본다. 이 사례의 null은 WiFi가 끊기고 PC가 유선을 쓰던 상태와 함께 관찰됐다.
서버를 실행하는 같은 PowerShell 또는 명령 프롬프트에서 아래 순서로 확인한다. 명령은 Microsoft 문서의 netsh wlan 구문에 따른 것이며, 이 사례의 기록에는 완성 명령·프로필 선택 코드가 없어 이 글에서 직접 실행해 검증한 명령은 없다. Microsoft Learn: netsh wlan
| 단계 | 확인 | 정상 기준 | 기준을 못 넘으면 |
|---|---|---|---|
| 1 | netsh wlan show interfaces | State가 connected이고 SSID 줄에 이름이 있다 | 연결 문제다. WiFi를 연결하고 1단계부터 다시 한다. 서버 코드는 아직 볼 단계가 아니다 |
| 2 | 서버의 /wifi 응답 | null이 아니고 SSID가 1단계의 이름과 같다 | SSID를 읽는 서버 코드(명령 호출·출력 파싱)를 본다. 출력 문구는 OS 언어에 따라 달라질 수 있다 |
| 3 | 비밀번호 | 응답에 비밀번호가 들어오고 입력칸에 채워진다 | 프로필 이름이 SSID와 다른지 netsh wlan show profiles로 저장된 프로필 목록을 보고, 서버가 관리자 권한인지 본다(아래 "관리자 권한으로 서버 띄우기"). Microsoft 문서는 key=clear 내보내기가 로컬 관리자 조건을 요구한다고 설명한다 |
| 4 | 화면 | 저장값이 없을 때 자동 입력되고, 버튼으로 다시 불러온다 | 브라우저 localStorage에 이전 값이 남아 자동 입력이 건너뛰어진 것은 아닌지 본다. 브라우저 개발자 도구(F12) → Application → Local Storage에서 이 서버 주소의 WiFi 관련 항목을 지우고 새로고침한다 |
비밀번호를 읽는 방법은 문서상 프로필을 XML로 내보내는 것이다. 형식은 netsh wlan export profile name="<프로필 이름>" key=clear folder="<출력 폴더>"이며, 내보낸 XML의 <keyMaterial>에 비밀번호가 평문으로 들어간다. 평문 파일이 남으므로 출력 폴더는 임시 위치로 잡고 확인 뒤 지운다. <프로필 이름>은 위 show profiles 목록에서 고르고, <출력 폴더>는 각자 채울 자리이다. 이 사례의 기록에서 서버가 실제로 프로필을 어떻게 골랐는지는 확인 못 했다.
Node 서버에서 같은 명령을 부르려면 child_process로 실행하고 출력 문자열을 읽으면 된다. 아래는 Node 공식 API 사용법에 따른 최소 예시이며, 이 글에서 실행해 검증하지 않았다. 출력 문구는 OS 언어에 따라 다를 수 있어 정규식은 자기 PC 출력에 맞춰 고친다.
const { execFileSync } = require('child_process');
const out = execFileSync('netsh', ['wlan', 'show', 'interfaces'], { encoding: 'utf8' });
const m = out.match(/^\s*SSID\s*:\s*(.+)$/m); // BSSID 줄은 SSID 앞에 공백만 오는 줄이 아니라 걸리지 않는다
const ssid = m ? m[1].trim() : null; // 연결이 없으면 null
비밀번호는 같은 방식으로 ['wlan','export','profile','name='+ssid,'key=clear','folder='+os.tmpdir()]를 실행한 뒤, 생성된 XML(Wi-Fi-<프로필 이름>.xml)을 읽어 <keyMaterial> 값을 꺼내고 파일을 지운다.
연결된 상태에서 값이 채워지는지는 이 기록에서 확인 못 했다. 당시 "파싱 로직은 정상"이라는 판단은 연결이 없는 상태에서 나온 것이라, 이 글은 받아들이지 않는다.
상황
Windows PC에서 로컬 서버를 실행하고, 운영자 화면이 WiFi 이름·비밀번호를 입력받아 브라우저 저장소 localStorage에 보관하며 QR을 만든다. 여기에 "현재 연결된 WiFi 정보를 기본값으로 쓰기"가 요청됐다. 브라우저에서는 WiFi 비밀번호를 직접 읽을 수 없어 서버가 운영체제 명령을 호출해 /wifi로 내려주기로 했다.
증상
서버를 띄워 검증한 단계에서 /wifi가 null을 반환했다. 이어 화면은 오류 없이 렌더링됐고 "현재 연결된 WiFi 불러오기" 버튼도 보였다. 하지만 실제 WiFi 정보가 입력됐다는 보고는 없다.
원인
이 사례에서 확인된 것은 netsh 확인 결과 State: disconnected였고 PC가 유선이었다는 점이다. 그래서 SSID가 없어 null이 나오는 것은 설명된다. 다만 netsh 출력 전체와 서버 파서 코드는 기록에 없다. 즉 연결이 없어서 null이 나왔다까지는 말할 수 있어도, 연결되면 정상 동작한다는 결론은 이 기록으로 뒷받침되지 않는다.
해결
위 결론의 표대로, 연결이 끊겨 있다면 WiFi를 연결한 뒤 1~4단계를 순서대로 통과시킨다. 서버 코드를 고치는 것은 1단계를 통과하고도 2~3단계에서 막힐 때다. 2단계의 SSID가 1단계와 같아야 한다는 기준으로 값이 맞게 읽혔는지 판정한다.
관리자 권한으로 서버 띄우기
3단계에서 비밀번호만 비어 있다면 서버 프로세스의 권한을 의심한다. 시작 메뉴에서 PowerShell(또는 명령 프롬프트)을 우클릭해 "관리자 권한으로 실행"을 고르고, 그 창에서 평소처럼 서버를 시작한다. 서버를 띄운 창이 관리자 창이어야 그 안에서 실행되는 netsh도 관리자 권한을 물려받는다. 이 방법은 Windows 일반 동작에 따른 안내이며, 이 사례의 기록에서 확인한 것은 아니다.
/wifi의 접근 범위 점검
이 설계에서 /wifi 응답에는 평문 비밀번호가 들어간다. 운영자 페이지만 호출한다는 설명은 있었지만, 다른 기기가 직접 요청했을 때 서버가 막는지는 설명되지 않았다. 아래를 확인하기 전에는 같은 네트워크의 다른 기기에서 열 수 있다고 가정한다.
- 뷰어·리더 폰에서
/wifi주소를 직접 열어 비밀번호가 응답에 나오는지 본다. 나온다면 접근 제한이 없는 것이다. - 내보낸 XML이 확인 뒤 지워졌는지 본다.
응답 JSON 형태, 명령 호출 방식, XML 파싱 방식은 기록에서 확인 못 했다.
덤 — QR 두 개가 카메라에 같이 잡힐 때
같은 화면에서 WiFi QR과 뷰어 접속 QR이 가까워 카메라에 함께 들어왔다. 카드 안에서 벌려도 부족해 width:100vw와 space-between으로 화면 양 끝에 배치했다고 보고됐다. 실제 휴대폰 스캔이 개선됐는지는 확인 못 했다.
취재 후기 — 값이 없다는 것과 코드가 맞다는 것
null이야. netsh가 정확히 뭘 주는 거야?netsh wlan show interfaces를 치면 현재 무선 어댑터의 연결 상태와 SSID, 즉 무선 네트워크 이름이 나와. State가 disconnected야. 이 PC는 유선으로 붙어 있고 WiFi는 끊겨 있었어. null은 설명이 돼. 근데 "파싱은 정상"이라는 말은 아직 아니야. 연결된 상태로 한 번도 안 돌려 봤잖아.<keyMaterial>을 읽는 설계야. key=clear 옵션을 주면 비밀번호가 글자 그대로 들어가. 출력 문구가 번역돼도 덜 흔들리니까 골랐고. /wifi에 평문 비밀번호가 실리는데, 운영자 페이지만 부른다는 설명뿐이지 다른 폰이 직접 열면 막히는지는 몰라. /wifi의 SSID, 비밀번호가 채워지는지, 화면 입력, 마지막으로 다른 폰의 직접 요청. 앞 단계가 안 되면 뒤로 안 간다.null이 나온 사실로 연결됐을 때의 성공까지 보증하지 말자.