خطای Can’t locate LWP/UserAgent.pm چیست؟
خطای Can't locate LWP/UserAgent.pm in @INC یک خطای رایج Perl در سرورهای لینوکسی است. این خطا زمانی رخ میدهد که یک اسکریپت Perl تلاش میکند ماژول LWP::UserAgent را فراخوانی کند اما این ماژول روی سرور نصب نیست.
ماژول LWP (Library for WWW in Perl) یکی از پرکاربردترین ماژولهای Perl برای ارسال درخواستهای HTTP و HTTPS است. بسیاری از ابزارهای سرور و کنترل پنلهایی مانند cPanel و دایرکت ادمین از این ماژول استفاده میکنند.
چه زمانی این خطا رخ میدهد؟
این خطا معمولاً هنگام اجرای اسکریپتهای نصب یا آپدیت کنترل پنل، اجرای برنامههای CGI، استفاده از ابزارهای خط فرمان مانند cpan یا yum، و اجرای اسکریپتهای بکاپ یا مانیتورینگ رخ میدهد.
روشهای رفع خطا
روش ۱: نصب با yum (CentOS/RHEL/AlmaLinux)
سادهترین روش، نصب بسته از مخازن رسمی:
yum install perl-libwww-perlیا در نسخههای جدید با dnf:
dnf install perl-libwww-perlروش ۲: نصب با apt (Ubuntu/Debian)
apt-get install libwww-perlروش ۳: نصب با CPAN
اگر بسته در مخازن سیستمعامل موجود نبود:
cpan install LWP::UserAgentیا:
perl -MCPAN -e 'install LWP::UserAgent'روش ۴: نصب دستی با cpanm
cpanm LWP::UserAgentاگر cpanm نصب نیست:
yum install perl-App-cpanminusبررسی صحت نصب
پس از نصب، بررسی کنید ماژول به درستی نصب شده:
perl -MLWP::UserAgent -e 'print "OK
"'اگر خروجی OK بود، ماژول با موفقیت نصب شده است.
ماژولهای وابسته
LWP::UserAgent به چندین ماژول دیگر Perl وابسته است. در صورت بروز خطاهای مشابه برای ماژولهای دیگر، بستههای زیر را هم نصب کنید:
yum install perl-libwww-perl perl-LWP-Protocol-https perl-IO-Socket-SSLاین خطا در کنترل پنلها
در سرورهای cPanel، این خطا ممکن است هنگام اجرای /scripts/ رخ دهد. در دایرکت ادمین، هنگام اجرای custombuild ممکن است دیده شود. در هر دو مورد، نصب بسته perl-libwww-perl مشکل را حل میکند.
اگر سرور شما نیاز به نصب و پیکربندی ماژولهای Perl و رفع خطاهای وابستگی دارد، خدمات کانفیگ سرور میهن هاستینگ میتواند کمک کند. همچنین اگر نیاز به سرور با دسترسی root برای نصب ماژولها دارید، یک سرور مجازی بهترین گزینه است.
⚙️ کانفیگ حرفهای سرور
نصب ماژولها، رفع خطاهای وابستگی و بهینهسازی سرور توسط تیم فنی میهن هاستینگ.