DTRAC센서 데이터가 비어 있습니다
스마트폰 센서의 기본 목록과 설치 앱의 설정을 비교합니다. foreground service, 필요한 권한, 센서 존재를 확인한 뒤 Room 배치의 시간·샘플 수·payload를 검사합니다. 통화 이벤트가 없으면 통화 배치가 없는 것이 정상일 수 있습니다.
건강 기록을 읽지 못합니다
원본 제공 앱에 기록이 있는지 먼저 확인합니다. Samsung Health의 자동 조회는 현재 운동·수면·심박 3종입니다. Health Connect는 기본 비활성이므로 권한만 허용했다고 수집이 시작되지는 않습니다. 기기 기록 가능, 제공 앱 공유 가능, DTRAC 구현 상태를 순서대로 확인하세요.
설문이 열리지 않거나 제출되지 않습니다
설문 ID와 화면 연결, 응답 가능한 회차·시각, 필수 문항과 분기를 확인합니다. 기상 기반 일정은 시간 기준이 확정되었는지도 봅니다. 응답 기한이 지난 상태에서 알림을 눌렀다고 제출이 다시 허용되지는 않습니다.
음성 설문은 파일 존재·녹음 권한·업로드 상태를 함께 확인합니다. 서버 전용 음성 정책의 업로드 실패는 제출 오류로 이어질 수 있습니다.
로컬 기록은 있지만 서버에 없습니다
- 전체 저장 모드가
local_only인지 확인합니다. studyId와participantId가 올바르게 등록되어 있는지 확인합니다.- 네트워크와 선택한 백엔드 설정을 확인합니다.
- 해당 레코드의
syncState와 동기화 작업 결과를 확인합니다. - 올바른 연구·참여자 경로 또는 Supabase 데이터 소스를 조회했는지 확인합니다.
재시도를 위해 참여자 ID를 임의로 바꾸거나 로컬 DB를 삭제하지 마세요. 원인 확인 전에 기존 데이터의 소유자와 오류 정보를 보존해야 합니다.
외부 앱에서 삼성헬스가 동작하지 않습니다
호스트 앱의 패키지명·서명과 Samsung Health 접근 조건을 확인합니다. 라이브러리 컴파일 성공은 외부 앱 검증 성공을 의미하지 않습니다. 현재 SDK 계획의 분리·패키징 작업도 필요합니다.
문제를 전달할 때
앱 버전, 기기·OS, 수집 타입, 발생 시각과 시간대, 권한 상태, 로컬 기록 유무와 오류 단계를 기록합니다. 실제 음성 파일·정밀 위치·참여자 식별자를 불필요하게 공유하지 말고 재현에 필요한 가상 예제로 정리하세요.