Question 1

Audiobookshelf Android 앱 설정에서 불가리아어 언어 옵션이 누락된 문제를 해결하는 방법

Accepted Answer

이 버그는 Audiobookshelf Android 앱 v0.11.0, v0.12.0-beta 및 이전 버전에 영향을 미칩니다: 불가리아어 번역 문자열은 이미 제공되고 있지만, 설정의 언어 드롭다운에 해당 언어 옵션이 표시되지 않습니다. 이 문제는 v0.13.0-beta에서 공식적으로 수정되었습니다. 앱을 v0.13.0-beta 또는 그 이후의 안정 버전으로 업그레이드하면 설정의 언어 목록에서 불가리아어를 선택할 수 있습니다.

Question 2

I don't have confirmed details about a specific bug in Audiobookshelf Android app version 0.14.1, so I can't point to a definitive known cause for that exact release. However, instant crashes on startup right after an update usually come down to a handful of common causes:

**Likely causes**

- **Local database migration failure** – If the update changed the app's internal storage schema, a failed migration can crash the app before the UI even loads. This is one of the most common reasons an update works for some users but crashes for others.
- **Android version incompatibility** – The update may rely on APIs not available (or behaving differently) on older Android versions.
- **Corrupted cached state** – Stale cache or config files from the previous version conflicting with the new build.
- **Server version mismatch** – Less likely to cause an *instant* crash, but the app does expect a minimum server version.

**Things to try**

1. **Clear the app cache** first (Settings → Apps → Audiobookshelf → Storage). This is non-destructive.
2. If that doesn't help, **clear app data** or reinstall. Warning: this deletes downloaded books and sign-in state, so you'll need to re-download and log back in.
3. Check for a **hotfix release** — if the crash is widespread, maintainers often push a quick follow-up version.
4. If you installed via the Play Store, you can try the APK from a previous release on GitHub (or F-Droid) to roll back temporarily.

**Getting a real diagnosis**

Capture the crash log with `adb logcat` right after launching the app — the stack trace will show exactly what's failing. Then check or file an issue at the [audiobookshelf-app GitHub repo](https://github.com/advplyr/audiobookshelf-app) or ask in the Audiobookshelf Discord, where the devs are active. Include your Android version, device model, and the log output.

If you can share the crash log or your device/Android version, I can help you interpret what's going wrong.

Accepted Answer

버전 0.14.1에서 다운로드 대기열에 새 필드가 추가되었지만, 비어 있지 않은 저장된 다운로드 대기열을 복원할 때 null 체크가 누락되어 시작 시 즉시 크래시가 발생했습니다(Galaxy S22/S25 및 Pixel 8과 같은 Android 16 기기에서 흔히 보고됨). 두 가지 해결 방법:

1. **0.14.2-beta 이상으로 업데이트**하면 크래시가 해결됩니다. Google Play 버전이 아직 승인되지 않은 경우 GitHub releases에서 APK를 직접 다운로드하세요: https://github.com/advplyr/audiobookshelf-app/releases/tag/v0.14.2-beta

2. **앱의 사용자 데이터 삭제(캐시만 삭제하는 것이 아님)**: Android 설정 → 앱 → Audiobookshelf → 저장 공간 → 데이터 삭제로 이동하세요. 캐시만 삭제해서는 해결되지 않습니다. 앱 설정에서 데이터와 캐시가 모두 사용량 0으로 표시되는지 확인할 수 있습니다(앱 자체는 총 약 48 MB). 이 작업을 수행하면 로컬 앱 설정과 다운로드된 파일이 삭제된다는 점에 유의하세요.

Question 3

Android에서 역방향 프록시를 통해 Audiobookshelf에 연결할 때 'java.security.cert.CertPathValidatorException: Trust anchor for certification path not found' 오류를 해결하는 방법은 무엇인가요?

Accepted Answer

이 오류는 일반적으로 앱의 버그가 아닌 리버스 프록시 또는 DNS 구성 오류를 나타냅니다. SSL Labs (https://www.ssllabs.com/ssltest/)와 같은 도구를 사용하여 SSL 인증서 체인을 확인하세요. 일반적인 해결 방법으로는 DNS 레코드 수정, 전체 인증서 체인이 제공되도록 보장, 또는 리버스 프록시(예: NGINX)에서 인증서 재설치가 있습니다. 한 사용자는 DNS 구성 오류를 수정하여 이 문제를 해결했습니다. 문제가 지속되면 프록시가 올바른 호스트명과 포트를 백엔드로 전달하는지 확인하세요.

Question 4

웹 앱에서는 동일한 검색이 가능한데 왜 Audiobookshelf Android 앱에서는 팟캐스트 에피소드나 설명을 검색할 수 없나요?

Accepted Answer

이 문제는 Audiobookshelf Android 앱 v0.11.0에서 발생하며, 웹 앱에서는 이미 사용 가능했던 팟캐스트 콘텐츠(에피소드 설명 포함) 검색 기능이 Android 클라이언트에서는 지원되지 않았습니다. 공식 수정은 v0.13.0-beta 릴리스에 포함되어 있습니다. 문제를 해결하려면 Audiobookshelf Android 앱을 v0.13.0-beta 또는 이후 버전으로 업그레이드하세요.

Question 5

왜 Audiobookshelf Android 앱의 다운로드가 완료되지 않고 416 Range Not Satisfiable 오류가 계속 기록되나요?

Accepted Answer

이는 Audiobookshelf Android 앱 0.14.1 / 0.14.1-beta의 알려진 버그입니다(issue #2041). 서버가 파일을 모두 전송한 후 앱이 파일 끝 또는 그 이후 지점부터 시작하는 Range 요청을 보내고, HTTP 416 응답을 받은 뒤 약 1초에 한 번씩 재시도하므로, 다운로드가 최종적으로 완료 처리되지 않아 책을 오프라인에서 계속 사용할 수 없게 됩니다. 다운로드를 완료되게 하는 클라이언트 측 해결 방법은 없습니다. 이전 수정(#2002, #1970을 닫은 수정)은 이 경로를 다루지 않았으며, 이 버그는 내부 저장소이든 사용자 지정 폴더이든 관계없이 대용량 단일 파일 m4b 다운로드에 영향을 미칩니다. 초당 약 1회 발생하는 416 재시도 폭주로 서버에 부하가 가해지는 것을 막으려면 앱을 강제 종료하세요(Android Settings → Apps → Audiobookshelf → Force Stop). 유일한 실질적인 해결책은 이 버그를 패치한 앱 릴리스로 업데이트하는 것이므로, GitHub issue/Play Store에서 수정된 빌드가 올라오는지 확인하세요.

Audiobookshelf App

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트