-9XXX, -10XXX (콜백/네트워크 Curl 에러)
-9xxx와 -10xxx 에러 코드는 libcurl 에러 코드 명세를 기반으로 정의된 네트워크 통신 오류입니다.
각 에러 코드의 마지막 자리 숫자는 Curl의 고유 에러 번호를 의미합니다. DRM 다운로드 콜백 과정에서 예외가 발생하면 -90XX 형태로 반환되며, 플레이 콜백 과정에서 예외 가 발생하면 -10XXX 형태의 코드로 매핑되어 대응됩니다.
에러 코드 콜백 대응표
| DRM 다운로드 콜백 | 플레이 콜백 | Curl 에러 유형 | 설명 |
|---|---|---|---|
| -9001 | -10001 | CURLE_UNSUPPORTED_PROTOCOL (1) | 지원하지 않는 프로토콜 (콜백 URL 형식 오류) |
| -9006 | -10006 | CURLE_COULDNT_RESOLVE_HOST (6) | DNS 해석 실패 (도메인을 IP 주소로 변환 불가) |
| -9007 | -10007 | CURLE_COULDNT_CONNECT (7) | 서버 도달 성공 후 접속 거부 또는 특정 포트 차단 |
| -9028 | -10028 | CURLE_OPERATION_TIMEDOUT (28) | 콜백 대상 서버의 응답 시간 초과 (Timeout) |
| -9056 | -10056 | CURLE_RECV_ERROR (56) | 데이터 수신 중 네트워크 연결 강제 종료 |
-9001 / -10001
- 에러 코드: -9001, -10001
- 요약: libcurl이 지원하지 않는 프로토콜 사용
원인
| 원인 | 설명 | 예시 |
|---|---|---|
| 프로토콜 누락 | https:// 등이 생략된 경우입니다. | example.com/callback |
| 잘못된 프로토콜 | 미디어 통신에 지원하지 않는 외부 프로토콜 형식을 지정한 경우입니다. | ftp://example.com/callback, file:///... |
| URL 형식 오류 | 특수 기호 기입 실수로 정상적인 주소 파싱이 불가능한 경우입니다. | http:/example.com (슬래시 누락), https//... (콜론 누락) |
| 공백/특수문자 포함 | Kollus 콘솔 설정 창에 주소를 입력할 때 미세한 공백이 포함된 경우입니다. | - |
진단
Kollus VOD 콘솔 시스템에 등록된 콜백 URL 주소를 그대로 복사한 뒤, 올바른 형식인지 검증하세요.
호출 주소가 https:// 또는 http:// 규칙으로 시작되는지 확인해야 합니다.
curl -v "YOUR_CALLBACK_URL"
-9006 / -10006
- 에러 코드: -9006, -10006
- 요약: 콜백 서버 도메인의 DNS 해석 실패
원인
- 일시적 네트워크 불안정: Wi-Fi 네트워크 전환 직후 또는 셀룰러 데이터 신호 환경이 일시적으로 약화된 경우입니다.
- DNS 서버 오류: 통신사(ISP) 및 사내 인트라넷 DNS 서버 장비에 일시적인 장애가 발생한 경우입니다.
- 사내망 내부 방화벽 차단: 기업, 학교, 공공기관 내부 공용망 환경에서 보안 정책상 외부의 특정 도메인 통신을 임의 차단한 경우입니다.
- 콜백 URL 도메인 오타: 존재하지 않는 도메인 주소를 잘못 입력한 경우입니다.
해결 방법
방법 A: 네트워크 재연결 (기본 조치)
- 이용 중인 디바이스의 Wi-Fi 설정을 껐다가 다시 켜거나, 셀룰러 데이터망으로 전환하여 통신 상태를 새로고침하세요.
- 현재 환경의 오래된 DNS 캐시 데이터를 초기화합니다.
방법 B: 콜백 URL 도메인 유효성 검증
다음 명령어를 실행하여 현재 설정된 콜백 대상 서버 도메인의 유통 경로를 추적하세요.
nslookup your-callback-domain.com
# 또는
dig your-callback-domain.com
- 결과 판별: 명령어 실행 결과 무응답 상태이거나
NXDOMAIN에러가 반환된다면, 도메인 주소에 오타가 있거나 DNS 등록 과정에 문제가 발생한 상태입니다.
방법 C: 사내망 보안 방화벽 예외 처리
Kollus 서버가 콜백 URL로 요청을 발송하는 구조이므로, 고객사 서버(콜백 수신 서버)가 Kollus 서버 IP에서 오는 요청을 허용해야 합니다.
- 참고 문서: 네트워크 화이트리스트 설정
방법 D: 기술 지원 문의
위의 조치를 순서대로 이행한 이후에도 에러 현상이 지속해서 검출되는 경우, 오류가 관찰되는 디바이스 OS 환경, 네트워크 회선 종류, 서비스 페이지 로그에 기록된 에러 발생 빈도 등의 구체적인 데이터들을 수집하여 기술 지원팀(tech_support@kollus.com)으로 문의해 주세요.
-9007 / -10007
- 에러 코드: -9007, -10007
- 요약: DNS 해석은 성공했으나 대상 서버 접속 실패
진단
- 고객사 콜백 수신 서버가 정상 구동되고 있는지 확인하세요.
- 네트워크 방화벽 설정에서 80(HTTP) 또는 443(HTTPS) 포트가 열려 있는지 확인하세요.
- Kollus 서버 IP가 고객사 콜백 서버 방화벽에서 허용됐는지 확인하세요.
- 참고 문서: 네트워크 화이트리스트 설정
-9028 / -10028
- 에러 코드: -9028, -10028
- 요약: 콜백 서버 응답 시간 초과 (Timeout)
진단 및 해결 방법
- 성능 기준: 콜백 서버의 응답 완료 시간은 최대 3초 이내 범위로 완결되도록 구조적으로 연산 최적화를 진행해야 합니다.
- 병목 구간 추적: Timeout이 반복된다면 데이터베이스(DB) 쿼리, 외부 API 호출 등으로 인한 병목 현상이 발생하고 있지 않은지 소스 코드 로직을 디버깅하세요.