وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

رفع Failed building wheel هنگام نصب بسته پایتون روی هاست

آموزش عیب‌یابی خطای ساخت wheel، یافتن نسخه سازگار Python و پیش‌نیازهای نصب بسته روی هاست.

انتشار:
توسط تیم فنی نت‌آرام
۴ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع Failed building wheel هنگام نصب بسته پایتون روی هاست در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
هنگام نصب بسته پایتون، چندین خط پیام می‌بینید و در پایان Failed building wheel نمایش داده می‌شود. این خط آخر فقط می‌گوید ساخت بسته شکست خورده؛ علت واقعی معمولاً کمی بالاتر در گزارش است. ممکن است برای نسخه پایتون یا معماری شما فایل آماده وجود نداشته باشد و ساخت از کد منبع به ابزار یا کتابخانه‌ای نیاز داشته باشد که روی هاست در دسترس نیست.
در این راهنما اول محیط واقعی و نخستین خطای مفید را پیدا می‌کنیم، بعد بسته به علت، نسخه سازگار یا پیش‌نیاز مناسب را انتخاب می‌کنیم. اجرای sudo و تغییر پایتون سیستم روی هاست اشتراکی معمولاً در اختیار کاربر نیست و لازم هم نیست اولین راه‌حل باشد.

۱. نام بسته و خطای اصلی را از گزارش بردارید

به خط‌های پیش از Failed building wheel نگاه کنید. نام بسته و نسخه‌ای را که در حال ساخت بوده یادداشت کنید. پیام Python.h: No such file or directory می‌تواند به فایل‌های توسعه Python اشاره کند؛ gcc: command not found به نبود کامپایلر و پیام کتابخانه‌ای مثل libpq به پیش‌نیاز همان بسته. خطای دسترسی یا کمبود حافظه مسیر دیگری دارد.
این‌ها مثال‌اند، نه تشخیص قطعی برای همه بسته‌ها. چند خط پیش از نخستین خطای واقعی و چند خط آخر را نگه دارید. آدرس مخزن خصوصی، رمز، توکن و مسیرهای محرمانه را قبل از ارسال گزارش حذف کنید.

۲. محیطی را که بسته در آن نصب می‌شود مشخص کنید

در Terminal یا SSH حساب، محیط نمایش‌داده‌شده در پنل Python App را فعال کنید و اجرا کنید:
کد / دستورpython --version python -m pip --version python -c "import sys, platform; print(sys.executable); print(platform.system(), platform.machine())"
خروجی، نسخه و مسیر مفسر، pip وابسته به آن و معماری را نشان می‌دهد. نسخه Python انتخاب‌شده در پنل را با نتیجه ترمینال مقایسه کنید. نصب در یک محیط مجازی دیگر مشکل برنامه وب را حل نمی‌کند. اگر محیط اشتباه است، راهنمای ModuleNotFoundError روش پیدا کردن آن را توضیح می‌دهد.

۳. ببینید فایل آماده سازگار وجود دارد یا نه

یک wheel آماده ممکن است برای نسخه Python، سیستم‌عامل و معماری خاص منتشر شده باشد. در محیط آزمایشی و برای بسته و نسخه تأییدشده، می‌توانید فقط دانلود فایل باینری را آزمایش کنید:
کد / دستورworkdir=$(mktemp -d) python -m pip download --only-binary=:all: --no-deps --dest "$workdir" 'example-package==1.2.3' ls -la "$workdir"
نام و نسخه نمونه را با مقدار واقعی عوض کنید و مطمئن شوید مخزن تنظیم‌شده معتبر است. این آزمایش وابستگی‌های فرعی را دانلود نمی‌کند و بسته را در برنامه نصب نمی‌کند. اگر فایل مناسب دانلود شد، مشخصات و سیاست نسخه پروژه را با مسئول توسعه تطبیق دهید. اگر پیام نبود فایل سازگار دیدید، ممکن است برای محیط فعلی wheel منتشر نشده باشد؛ ناسازگاری نسخه، محدودیت مخزن یا تنظیمات شبکه نیز می‌تواند دخیل باشد.
تغییر نسخه Python در پنل ممکن است بسته‌های دیگر پروژه را ناسازگار کند. نسخه پیشنهادی بسته و نیازمندی‌های برنامه را در یک برنامه آزمایشی جدا با هم بررسی کنید و نسخه فعال را تا قبولی آزمون نگه دارید.

۴. اگر ساخت از کد منبع لازم است

راهنمای همان بسته را برای نسخه سیستم‌عامل و Python بخوانید. برخی بسته‌ها به کامپایلر، فایل‌های توسعه Python یا کتابخانه‌های سیستم نیاز دارند. روی هاست اشتراکی، نام دقیق بسته، نسخه Python، معماری و نخستین خطای ساخت را برای پشتیبانی بفرستید تا امکان پشتیبانی و پیش‌نیاز مجاز را بررسی کند.
روی سرور مستقل، مدیر سیستم می‌تواند پس از بررسی مخازن و سازگاری توزیع، بسته توسعه مناسب را نصب کند؛ نام بسته در Debian، Ubuntu و AlmaLinux یکسان نیست و انتخاب اشتباه ممکن است با نسخه Python پروژه مطابقت نداشته باشد. دانلود فایل کتابخانه ناشناس از سایت‌های پراکنده یا خاموش‌کردن کنترل امنیت pip توصیه نمی‌شود.
اگر خطا به کمبود حافظه یا فضای موقت اشاره می‌کند، مقدار سهمیه حساب و زمان خطا را بررسی کنید. ساخت یک بسته بومی ممکن است موقتاً منابع زیادی بخواهد؛ نصب موفق فایل آماده الزاماً ثابت نمی‌کند برنامه هنگام اجرا نیز ظرفیت کافی دارد.

۵. نصب نهایی و عملکرد برنامه را امتحان کنید

در محیط مجازی آزمایشی و با فایل نیازمندی تأییدشده:
کد / دستورpython -m pip install -r requirements.txt python -m pip check
فرمان نصب ممکن است کد ساخت بسته مورد اعتماد را اجرا کند. pip check ناسازگاری اعلام‌شده وابستگی‌ها را گزارش می‌کند، اما جای آزمون برنامه نیست. بعد کتابخانه موردنیاز را import و مسیر واقعی برنامه را در محیط پنل آزمایش کنید. اگر هش بسته با مقدار پروژه فرق دارد، راهنمای خطای هش pip را بخوانید و کنترل هش را حذف نکنید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام