[Python] PyInstaller 패키징 시 동적 임포트 모듈 누락

문제

PyInstaller 패키징 시 특정 모듈을 찾을 수 없는 오류 발생

ModuleNotFoundError: No module named 'azure.devops.v7_0.core'

해결과정

로컬 환경 및 가상 환경 모두 해당 패키지는 설치되어 있었으며, 패키징을 하지 않을 경우에는 정상적으로 작동함.

해당 모듈을 직접 확인해본 결과 코드에서 사용하는 일부 모듈이 동적 임포트를 통해 로드되고 있었음.

PyInstaller는 정적으로 참조된 모듈만 포함하기 때문에 동적으로 로드되는 모듈은 패키징 과정에서 누락 되는 점 확인.

조치

필요한 동적 모듈을 확인하고 --hidden-import 옵션을 추가하여 오류를 해결.

pyinstaller --hidden-import=azure.devops.v7_0.core --hidden-import=azure.mgmt.resource ...

정리

1. 패키징 과정에서 필요한 모듈은 명시적으로 표시.
2. 동적으로 로드되는 모듈은 --hidden-import 옵션을 이용.
3. --hidden-import 옵션을 사용할 경우, 불필요한 모듈이 포함되지 않도록 주의.