[오류 해결] googletrans 사용 중 오류

 

🐞 1. 오류 상황

• 발생 환경: {Windows11, Python3.xxx/googletrans, vscode}
• 오류 코드: ModuleNotFoundError: No module named 'cgi'

import googletrans

...

• 에러 메시지: 

Traceback (most recent call last):
    import httpx
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\__init__.py", line 2, in <module>      
    from ._api import delete, get, head, options, patch, post, put, request, stream
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\_a    import httpx
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\__init__.py", line 2, in <module>
    from ._api import delete, get, head, options, patch, post, put, request, stream     
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\_api.py", line 3, in <module>
    from ._client import Client, StreamContextManager
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\_client.py", line 8, in <module>
    from ._auth import Auth, BasicAuth, FunctionAuth
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\_auth.py", line 10, in <module>
    from ._models import Request, Response
  File "c:\Users\user\AppData\Local\Programs\Python\Python313\Lib\site-packages\httpx\_models.py", line 1, in <module>
    import cgi
ModuleNotFoundError: No module named 'cgi'

 

---

🔍 2. 원인 분석

• 원인: googletrans 라이브러리가 사용하는 cgi 모듈이 pyhon 3.11 이상에서 삭제됨 (사용하는 파이썬 버전- 3.11)
• 참고 자료: https://docs.python.org/3/library/cgi.html

 

---

🚀 3. 해결 방법

• 시도한 방법들:
  1. cgi 모듈 대신 legacy-cgi 사용
     
     • cgi 모듈이 더 이상 최신 python 버전에 포함되지 않아서 대체하거나 복원하기 위해 만들어진 패키지
     • install 후 코드 정상 동작 확인함
     • 단, googletrans는 비공식 라이브러리이므로 추후 문제 발생을 대비해서 안정적인 API 사용 권장
• 최종 해결 방법: googletrans 대신, 더 안정적인 deep-translator 라이브러리를 사용

pip install deep-translator

 

---

💡 4. 배운 점

• Python의 모듈 제거 또는 변경에 따라 오래된 라이브러리가 최신 버전과 호환되지 않을 수 있다는 점
• 비공식 라이브러리(googletrans)는 업데이트가 느리거나 유지보수가 부족할 수 있으므로, 항상 대안을 고려해야 함
• 외부 라이브러리에 의존하는 프로젝트는 Python 버전과의 호환성을 사전에 확인하는 것이 중요

 

---

📚 5. 참고 자료

• https://docs.python.org/3/library/cgi.html
• https://pypi.org/project/legacy-cgi/