Termux에서 FastAPI 설치 실패 해결하기 #

들어가기 #

Termux에서 간단히 FastAPI 테스트를 하려다가 설치 단계에서 계속 막혔다. 처음에는 fastapi 자체 문제라고 생각했지만, 실제 원인은 pydantic-core 빌드에 필요한 도구가 누락된 상태였다.

같은 증상을 겪는 분들이 로그를 붙잡고 오래 헤매지 않도록, 내가 확인한 오류 흐름과 해결 순서를 정리한다.

---

1. 설치할 때 어떤 에러가 나왔나 #

실패 흐름은 아래처럼 반복됐다.

1. python -m pip install fastapi
2. 의존성 설치 중 pydantic-core 빌드 실패
3. pip 업그레이드 안내가 뜨지만 Termux 환경에서는 이 방식이 도움이 안 됨
4. python -m pip install pydantic 단독 설치 시 can't find Rust compiler
5. Rust 설치 후에는 aarch64-linux-android-ar 관련 오류가 추가로 발생

여기까지 오면 결론은 명확하다. 파이썬 패키지 자체 문제가 아니라, Termux의 네이티브 빌드 툴체인 부족 문제다.

---

2. 해결 순서 (그대로 따라 하면 됨) #

아래 순서로 설치하니 정상적으로 진행됐다.

bashCopy
pkg install binutils
pkg install rust
pkg install build-essential
python -m pip install pydantic
python -m pip install fastapi

왜 이 순서가 중요한지는 아래 두 줄로 요약된다.

• rust: pydantic-core를 빌드할 때 필요
• binutils: aarch64-linux-android-ar 같은 툴 제공

가능하면 가상환경(venv)에서 진행하는 것을 추천한다. 기존 패키지와 충돌 가능성을 줄일 수 있다.

---

3. 설치 후 확인할 점 (접속 범위) #

설치가 끝난 뒤 서버 실행 자체는 됐지만, 접속 범위는 따로 확인이 필요했다.

• 휴대폰 내부 localhost 접속: 가능
• 같은 와이파이의 다른 PC에서 안드로이드 IP 접속: 환경에 따라 실패 가능

이 부분은 파이썬 라이브러리 문제가 아니라 안드로이드 단 정책/네트워크 제한 영향이 크다. 외부 기기 접근이 필요하면 방화벽, 포트, 단말 보안 정책을 함께 점검해야 한다.

---

4. 빠른 체크리스트 #

• 오류 로그에 Rust compiler / aarch64-linux-android-ar가 보이는지 확인
• binutils, rust, build-essential 먼저 설치
• pydantic 설치 성공 후 fastapi 설치
• 로컬 접속과 외부 기기 접속을 분리해서 테스트

---

마무리 #

Termux에서 FastAPI가 설치되지 않을 때는 fastapi 자체보다 pydantic-core의 네이티브 빌드 환경을 먼저 의심하는 게 훨씬 빠르다. 같은 오류를 만난 분들께 이 순서가 바로 해결에 도움이 되었으면 한다.

원문 #

• shyim, Install FastAPI, Pydantic on termux LOL
  https://velog.io/@shyim/Install-FastAPI-Pydantic-on-termux-LOL