---
title: "문제 해결"
description: "DoveRunner Mobile App Security CLI 도구의 일반적인 문제와 해결 방법에 대한 문제 해결 가이드입니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

DoveRunner Mobile App Security CLI 도구 사용 중 발생하는 오류는 종료 코드로 식별됩니다. 아래 표에서 종료 코드를 확인하고 해결 절차를 따르세요. 문제가 해결되지 않으면 [DoveRunner HelpDesk](https://support.doverunner.com)로 문의하세요.

## 종료 코드 레퍼런스

| 종료 코드 | 설명 | 조치 |
|-----------|------|------|
| **100** | CLI 도구에 전송된 매개변수 없음 | CI 설정에서 필수 매개변수가 모두 구성되어 있는지 확인하세요 |
| **101** | 구성 파일 경로 미입력 또는 해당 경로에 파일 없음 | 유효한 구성 파일 경로가 입력되었는지 확인하세요 |
| **103** | 실링 정보 검색 실패 | CLI 도구 액세스 권한을 확인하고, 문제가 지속되면 로그와 함께 HelpDesk에 문의하세요 |
| **110** | 인증 실패 또는 실링 옵션 유효성 검사 실패 | [아래 상세 내용 참고](#110--인증--옵션-유효성-검사-실패) |
| **120** | CLI 도구에 전달된 잘못된 실링 옵션 | [아래 상세 내용 참고](#120--잘못된-실링-옵션) |
| **130** | APK/AAB 파일 업로드 실패 | `srcapk` 경로에 파일이 존재하고 네트워크가 연결되어 있는지 확인하세요. [재시도 동작 참고](#네트워크-재시도-동작) |
| **140** | 실링 요청 실패 | `sealing_preset_name`을 지정한 경우 [프리셋 이름을 확인](#프리셋을-찾을-수-없는-경우)하고, 그 외에는 로그를 HelpDesk로 전송하세요. [재시도 동작 참고](#네트워크-재시도-동작) |
| **150** | 실링 프로세스 실패 | 로그를 HelpDesk로 전송하세요. [재시도 동작 참고](#네트워크-재시도-동작) |
| **160** | 실링된 APK/AAB 다운로드 실패 | 네트워크 연결을 확인하세요. [재시도 동작 참고](#네트워크-재시도-동작) |
| **250** | 서버 불안정 | 5분 후 재시도하고, 문제가 지속되면 로그와 함께 HelpDesk에 문의하세요 |

---

## 110 — 인증 / 옵션 유효성 검사 실패

### 인증 실패 원인

**1. `authkey` 미입력 또는 유효하지 않음**

입력한 `authkey`가 계정에 발급된 키와 일치하는지 확인하세요.

**2. 도구 버전 또는 해시 값이 유효하지 않음**

CLI 도구가 수정되었거나 무결성 검사를 통과하지 못한 경우입니다. DoveRunner Mobile App Security 콘솔에서 공식 버전을 다운로드하여 다시 시도하세요.

**3. `authkey`에 등록되지 않은 패키지로 실링 시도**

계정에 등록된 앱 패키지만 실링할 수 있습니다. 패키지 등록을 요청한 후 진행하세요.

### 실링 옵션 유효성 검사 실패 원인

**1. `block_environment` 값 오류** — `emulator`, `rooting`만 허용됩니다.

**2. `allow_external_tool` 값 오류** — `macro`, `sniff`만 허용됩니다.

**3. `deploymode` 값 오류** — `test`, `release`만 허용됩니다.

**4. `dex_encrypt` 값 오류** — `yes`, `no`만 허용됩니다.

**5. `app_type` 값 오류** — `GAME`, `NON_GAME`만 허용됩니다. 이 옵션은 2.x 버전에서만 사용합니다.

**6. `action_*` 값 오류** — `block`, `monitor`, `callback`, `allow`만 허용됩니다.

**7. 3.3.0.0 미만 버전에서 `action_*` 옵션 사용** — [위협 대응 정책](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/basic-configuration/#%EC%9C%84%ED%98%91-%EB%8C%80%EC%9D%91-%EC%A0%95%EC%B1%85-3300-%EC%9D%B4%EC%83%81) 옵션(`action_*`)은 `service_version` 3.3.0.0 이상에서만 사용할 수 있으며, 그 외 버전에서는 실링 요청이 거부됩니다. `service_version=latest`가 3.3.0.0 미만으로 해석되는 경우에도 동일합니다. `service_version`을 3.3.0.0 이상으로 지정하거나 [기존 버전 옵션](https://docs.doverunner.com/ko/mobile-app-security/android/cicd/legacy-options/)을 사용하세요.

**8. 지원되지 않는 옵션 또는 오타** — 옵션명과 입력 값을 다시 확인하세요.

### 인증 중 네트워크 불안정

CLI 도구는 10초 간격으로 최대 10회 재시도합니다. 네트워크가 안정되면 자동으로 다음 단계로 진행됩니다.

```
[재시도 메시지]
요청을 일시적으로 완료할 수 없습니다. 다시 시도하세요... ( 1 / 10 )

[오류 메시지]
유효성 검사가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 110)
```

---

## 120 — 잘못된 실링 옵션

**1. 잘못된 `url`**

URL이 유효하지 않거나 방화벽에 의해 차단된 경우 실링을 처리할 수 없습니다. CLI 도구는 HTTPS(SSL)를 사용하므로 환경에서 HTTPS 아웃바운드 연결이 허용되어 있는지 확인하세요.

**2. 잘못된 `srcapk` 경로**

`srcapk` 옵션이 입력되지 않았거나, 지정된 경로에 APK/AAB 파일이 존재하지 않습니다.

**3. 잘못된 `sealedapk` 경로**

`sealedapk` 옵션이 입력되지 않았습니다.

---

## 네트워크 재시도 동작

종료 코드 **130**, **140**, **150**, **160**에서는 CLI 도구가 10초 간격으로 자동 재시도합니다. 130, 140, 160은 최대 10회, 150은 실링 프로세스 중 최대 40회 재시도합니다. 네트워크가 안정되면 자동으로 다음 단계로 진행됩니다.

```
[재시도 메시지]
요청을 일시적으로 완료할 수 없습니다. 다시 시도하세요... ( 1 / 10 )
```

재시도 횟수를 모두 소진한 후에도 네트워크가 불안정하면 다음 오류 메시지가 표시됩니다.

```
[종료 코드 130]
APK/AAB 파일 업로드가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 130)

[종료 코드 140]
실링 요청이 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 140)

[종료 코드 150]
실링 처리가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 150)

[종료 코드 160]
APK/AAB 파일 다운로드가 실패했습니다. 실링을 다시 시도하세요. 문제가 해결되지 않으면 헬프 센터를 통해 문의하세요. [이유 : 예외 원인] (종료 코드: 160)
```

---

## 기타 증상

### 프리셋을 찾을 수 없는 경우

`sealing_preset_name`에 지정한 프리셋이 없으면 종료 코드 140과 함께 아래 메시지가 출력되며 실링이 실패합니다.

```
Sealing preset is not exist. Please check the sealing_preset_name value.
```

**조치 방법:** 프리셋 이름이 콘솔에서 만든 프리셋과 대소문자까지 정확히 일치하는지, 그리고 해당 프리셋이 `authkey` 계정에 속해 있는지 확인하세요.

### 실링이 1시간 이상 지속되는 경우

500MB 이상의 앱은 업로드/다운로드에 추가 시간이 소요될 수 있지만, 실링 처리 자체가 1시간을 초과하는 것은 비정상 동작입니다.

**조치 방법:** 현재 세션은 그대로 두고, 새 세션에서 실링을 다시 시도하세요. 문제가 반복되면 실링 로그와 함께 HelpDesk에 문의하세요.

### 다른 계정에 등록된 앱 실링 시 실패

다른 계정에 등록된 앱을 실링하려고 하면 실패합니다. 사용 중인 `authkey`와 앱 소유 계정이 동일한 팀 또는 조직에 속해 있는지 확인하세요.

### 업로드/다운로드 속도가 너무 느린 경우

전송 속도가 느린 것은 실링 문제가 아닌 네트워크 환경 문제일 수 있습니다.

**조치 방법:**
1. Wi-Fi를 사용 중이라면 유선 연결로 변경 후 다시 시도하세요.
2. 여전히 느리다면 현재 접속 지역, 앱 크기, 실링 로그를 포함하여 [HelpDesk](https://support.doverunner.com)에 문의하세요.

### 이외 오류

이 가이드에서 다루지 않은 오류가 발생한 경우, 실링 로그와 환경 정보를 포함하여 [HelpDesk](https://support.doverunner.com)에 문의하세요.