-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 환경, 네트워크 회선 종류, 서비스 페이지 로그에 기록된 에러 발생 빈도 등의 구체적인 데이터들을 수집하여 기술 지원팀(PE, tech_support@catenoid.net)으로 문의하세요.
-9007 / -10007
- 에러 코드: -9007, -10007
- 요약: DNS 해석은 성공했으나 대상 서버 접속 실패
진단
- 고객사 콜백 수신 서버가 정상 구동되고 있는지 확인하세요.
- 네트워크 방화벽 설정에서 80(HTTP) 또는 443(HTTPS) 포트가 열려 있는지 확인하세요.
- Kollus 서버 IP가 고객사 콜백 서버 방화벽에서 허용됐는지 확인하세요.
- 참고 문서: 네트워크 화이트리스트 설정
-9028 / -10028
- 에러 코드: -9028, -10028
- 요약: 콜백 서버 응답 시간 초과 (Timeout)
진단 및 해결 방법
- 성능 기준: 콜백 서버의 응답 완료 시간은 최대 3 초 이내 범위로 완결되도록 구조적으로 연산 최적화를 진행해야 합니다.
- 병목 구간 추적: Timeout이 반복된다면 데이터베이스(DB) 쿼리, 외부 API 호출 등으로 인한 병목 현상이 발생하고 있지 않은지 소스 코드 로직을 디버깅하세요.