---
title: "문제 해결"
description: "DoveRunner Mobile App Security CLI 도구의 일반적인 문제와 해결 방법에 대한 문제 해결 가이드입니다."
---
> For the complete documentation index, see [llms.txt](/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** | 실링 요청 실패 | 로그를 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`만 허용됩니다.

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

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

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)
```

---

## 기타 증상

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

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

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

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

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

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

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

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

### 이외 오류

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