[트러블 리포트::python] pip install psutil 오류 (rocky linux)

오류 내용

$ pip install psutil
Collecting psutil
  Using cached https://files.pythonhosted.org/packages/2a/80/336820c1ad9286a4ded7e845b2eccfcb27851ab8ac6abece774a6ff4d3de/psutil-7.0.0.tar.gz
Installing collected packages: psutil
  Running setup.py install for psutil ... error
    Complete output from command /[project folder]/venv/bin/python3 -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-ennc80ff/psutil/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" install --record /tmp/pip-jt9gpr4y-record/install-record.txt --single-version-externally-managed --compile --install-headers /home/web/fastapi-app/venv/include/site/python3.6/psutil:

카페24 호스팅 서버에 fastapi 및 관련 모듈 설치 중에 발생한 오류 입니다.

Rocky Linux에서는 psutil 설치 오류가 발생하는 경우, 필요한 개발 패키지를 설치한 후 다시 시도하면 해결될 가능성이 높습니다. Rocky Linux는 CentOS/RHEL 계열이기 때문에, 아래 방법을 시도해 보십시오.

---

🛠 해결 방법 순서

1️⃣ 개발 패키지 설치 (GCC, Python 개발 라이브러리)

Rocky Linux에서는 psutil이 C 확장을 포함하고 있어서, 컴파일할 때 필요한 패키지를 먼저 설치해야 합니다.

sudo dnf groupinstall "Development Tools" -y
sudo dnf install gcc python3-devel -y

---

2️⃣ 가상 환경(venv) 활성화

설치 중인 환경이 가상 환경이라면, 다시 활성화하고 pip을 업데이트 해야 합니다.

source /home/web/fastapi-app/venv/bin/activate
pip install --upgrade pip setuptools wheel

---

3️⃣ psutil 설치 시도

pip install psutil

만약 그래도 안 되면, 캐시를 삭제하고 다시 설치해 보십시오.

pip cache purge
pip install --no-cache-dir psutil

---

4️⃣ Python 버전 확인 (3.6이면 업그레이드 필요)

로그를 보면 /home/web/fastapi-app/venv/include/site/python3.6/psutil 경로가 나와 있는데,
Python 3.6은 지원이 종료되었기 때문에 최신 버전(3.8 이상)으로 업그레이드하는 것이 좋습니다.

🔹 현재 Python 버전 확인:

python3 --version

🔹 Python 3.8 이상 설치:

sudo dnf install python3.8 python3.8-devel -y

🔹 새 가상 환경 생성 후 다시 시도:

rm -rf /home/web/fastapi-app/venv
python3.8 -m venv /home/web/fastapi-app/venv
source /home/web/fastapi-app/venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install psutil

---

🔥 최종 정리

1. 필수 패키지 설치

   sudo dnf groupinstall "Development Tools" -y
   sudo dnf install gcc python3-devel -y
   

2. 가상 환경 다시 활성화

   source /home/web/fastapi-app/venv/bin/activate
   pip install --upgrade pip setuptools wheel
   

3. psutil 설치 시도

   pip install psutil
   

4. 그래도 안 되면, Python 버전 확인 후 업그레이드 (python3 --version)
5. Python 3.8 이상이 필요하면 업그레이드 (sudo dnf install python3.8 python3.8-devel -y)
6. 가상 환경 새로 생성 후 다시 설치 시도

   rm -rf /home/web/fastapi-app/venv
   python3.8 -m venv /home/web/fastapi-app/venv
   source /home/web/fastapi-app/venv/bin/activate
   pip install --upgrade pip setuptools wheel
   pip install psutil
   

이렇게 하면 psutil 설치가 정상적으로 될 걸로 보입니다! 🚀