자주 겪는 문제 — Notikit 문서

증상	원인과 조치
발송은 성공인데 알림이 안 온다	Firebase 미설정이면 log-only 로 기록만 됩니다. 프로젝트 설정 > Firebase 를 확인하세요.
웹에서 알림이 두 번 뜬다	서비스워커를 최신 템플릿으로 교체하세요. 서버는 웹에 data-only 로 보내고 워커가 표시를 담당합니다.
클릭이 집계되지 않는다	서비스워커 등록 URL 에 `base`·`key` 쿼리가 붙어 있는지 확인하세요. SDK 의 `register()` 가 자동으로 붙입니다.
api-key 를 바꿨는데 클릭이 계속 실패한다	워커가 최초 설치 때의 설정을 쓰고 있을 수 있습니다. `register()` 가 불일치를 감지해 재설치합니다 — 최신 SDK 인지 확인하세요.
`403 identity_hash invalid`	HMAC 키가 `api_secret` 인지, 대상 문자열이 `user_id` 그대로인지, 결과가 hex 인지 확인하세요.
같은 사람에게 두 번 온다	토큰 갱신 시 재등록 대신 `/devices/rotate` 를 쓰는지 확인하세요.
국가가 기록되지 않는다	`TRUSTED_PROXY_HOPS` 가 `0` 이면 IP 를 신뢰하지 않습니다. 프록시 홉 수를 설정하세요.
탭이 열려 있을 때 알림이 안 뜬다	포그라운드 메시지는 서비스워커가 아니라 창으로 옵니다. SDK 의 `register()` 가 핸들러를 붙이므로 최신 버전인지 확인하세요.