gyp ERR! build error (node-gyp)

همه خطاها رایگان
Node.js و npm

gyp ERR! build error (node-gyp)

node-gyp نتوانست یک افزونه بومی (C/C++) را از سورس کامپایل کند.

معنی آن

node-gyp نتوانست یک افزونه بومی (C/C++) را از سورس کامپایل کند.

علت احتمالی

زنجیره ابزار ساخت مفقود (Python، make، یک کامپایلر C++، یا Windows Build Tools)، یا نسخه Node ناسازگار.

راه رفع آن

پیش‌نیازهای ساخت را نصب کنید (build-essential + python3 در لینوکس، ابزارهای خط فرمان Xcode در macOS، یا Visual Studio Build Tools در ویندوز)، سپس کش را پاک و دوباره نصب کنید. بررسی کنید افزونه از نسخه Node شما پشتیبانی می‌کند.

سایر خطاهای Node.js و npm

Error: Cannot find module 'x' Node نتوانست ماژولی را که سعی کردید require یا import کنید پیدا کند. ERR_MODULE_NOT_FOUND یک import ماژول ES نتوانست به فایلی روی دیسک حل شود. ERR_REQUIRE_ESM شما require() را روی بسته‌ای استفاده کردید که فقط به‌عنوان ماژول ES ارائه می‌شود. Error: listen EADDRINUSE: address already in use پورتی که سرور شما سعی کرد به آن bind کند از قبل توسط فرآیند دیگری اشغال شده است. Error: ENOENT: no such file or directory یک عملیات فایل‌سیستمی به فایل یا دایرکتوری‌ای ارجاع داد که وجود ندارد. Error: EACCES: permission denied فرآیند مجوز خواندن، نوشتن یا bind کردن فایل، دایرکتوری یا پورت درخواست‌شده را ندارد. Error: connect ECONNREFUSED یک تلاش اتصال به‌طور فعال رد شد چون چیزی روی آن میزبان و پورت گوش نمی‌دهد. UnhandledPromiseRejectionWarning یک promise رد شد و هیچ .catch() یا try/catch خطا را مدیریت نکرد. FATAL ERROR: JavaScript heap out of memory هیپ جاوااسکریپت V8 از محدودیت حافظه خود فراتر رفت و Node متوقف شد. error:0308010C:digital envelope routines::unsupported یک روال هش/رمزنگاری قدیمی (اغلب در Webpack 4) توسط OpenSSL 3 در نسخه‌های جدیدتر Node پشتیبانی نمی‌شود. npm ERR! code ERESOLVE npm نتوانست درخت وابستگی را به دلیل الزامات وابستگی همتای متضاد حل کند. npm ERR! code ELIFECYCLE یک اسکریپت چرخه حیات npm (مانند build، test، یا یک قلاب pre/post) با وضعیت غیرصفر خارج شد. npm ERR! code ENOENT (package.json) npm نتوانست یک package.json در دایرکتوری فعلی پیدا کند. npm ERR! 404 Not Found بسته یا نسخه درخواست‌شده در رجیستری npm پیدا نشد. npm ERR! code EACCES به npm مجوز فایل‌سیستمی داده نشد، معمولاً هنگام نوشتن در یک دایرکتوری سراسری یا کش آن. npm WARN unmet peer dependency یک بسته وابستگی همتایی اعلان می‌کند که مفقود است یا در نسخه‌ای برآورده‌نشده قرار دارد. npm ERR! code EBADENGINE (unsupported engine) بسته نصب‌شده نسخه Node یا npm‌ای را لازم دارد که با محیط شما مطابقت ندارد.

درباره جستجوی کد خطا

جستجوگر کدهای خطا یک فهرست قابل جستجو از بیش از ۲۰۰ پیام و کد خطای رایج در ۱۲ دسته است: کدهای وضعیت HTTP، کدهای خطای Windows، خطاهای مرورگر و شبکه، JavaScript، Python، PHP، Node.js و npm، Java، MySQL، Git، خطاهای شل Linux و کدهای ایمیل/SMTP. هر مورد به زبانی ساده نوشته شده تا عیب‌یابی سریع باشد.

هر خطا در سه بخش توضیح داده می‌شود: معنای واقعی پیام، علت رایج آن و مراحل مشخص برای رفع آن. این ساختار یک رشتهٔ مبهم مانند ERR_CONNECTION_REFUSED یا 0x80070005 را به یک چک‌لیست عملی تبدیل می‌کند، نه یک حدس و گمان.

می‌توانید فهرست را بر اساس دسته فیلتر کنید، بر اساس کد، ثابت یا بخشی از پیام جستجو کنید، و هر کد را با یک کلیک کپی کنید. هر خطا صفحهٔ اختصاصی خودش را با خطاهای مرتبط از همان دسته دارد، بنابراین می‌توانید لینک مستقیم به راه‌حل دقیق را نشانک‌گذاری یا به اشتراک بگذارید.

نحوه استفاده از جستجوی کد خطا

  1. کد یا پیام خطا را در کادر جستجو تایپ کنید — برای مثال 404، ERR_NAME_NOT_RESOLVED یا 0x80070005.
  2. اگر جستجو نتایج زیادی برگرداند، با فیلتر دسته (HTTP، Windows، JavaScript، MySQL و غیره) نتایج را محدود کنید.
  3. مورد منطبق را باز کنید تا معنای آن، علت احتمالی و روش رفع آن را بخوانید.
  4. از دکمهٔ کپی برای گرفتن کد دقیق جهت گزارش باگ یا تیکت پشتیبانی استفاده کنید.
  5. بخش خطاهای مرتبط را برای دیدن سایر خطاهای همان دسته بررسی کنید.

سوالات متداول

این ابزار ۱۲ دسته را پوشش می‌دهد: کدهای وضعیت HTTP، خطاهای سیستمی Windows، خطاهای مرورگر و شبکه، JavaScript، Python، PHP، Node.js و npm، Java، MySQL، Git، خطاهای شل Linux و کدهای پاسخ ایمیل/SMTP — در مجموع بیش از ۲۰۰ مورد.

با کلمات کمتری جستجو کنید. کوتاه‌ترین بخش منحصربه‌فرد بهترین نتیجه را می‌دهد: فقط کد عددی («404»، «0x80070005») یا نام ثابت («ERR_NAME_NOT_RESOLVED») به‌جای جملهٔ کاملی که سیستم شما نمایش داده است.

بله. هر مورد یک صفحهٔ جزئیات اختصاصی دارد که معنا، علت احتمالی و راه‌حل را توضیح می‌دهد، به‌همراه خطاهای مرتبط از همان دسته. می‌توانید آن را نشانک‌گذاری کنید یا لینک را مستقیماً برای همکار یا تیکت پشتیبانی ارسال کنید.

راه‌حل‌ها روش استاندارد و مورد پذیرش عمومی برای هر خطا را توصیف می‌کنند. با این حال، ابتدا بخش علت احتمالی را بخوانید — یک کد می‌تواند چند علت داشته باشد و تطبیق علت با وضعیت شما مشخص می‌کند کدام راه‌حل کاربرد دارد.

بله، کاملاً رایگان است. می‌توانید بدون نیاز به حساب کاربری جستجو کنید، فهرست دسته‌ها را مرور کنید و هر تعداد صفحهٔ جزئیات خطا که نیاز دارید باز کنید.
اشتراک‌گذاری
ابزارهای مرتبط
فرمت‌کننده کد HTML، CSS و JavaScript را زیباسازی کنید — indent را دوباره تنظیم کنید و شکست خط اضافه کنید تا کد نامرتب یا فشرده خوانا شود. رایگان
فشرده‌کننده کد HTML، CSS و JavaScript را کوچک کنید — comment‌ها و فضای سفید را حذف کنید تا فایل‌ها کوچک‌تر و سریع‌تر بارگذاری شوند. رایگان
قالب‌بند آرایه آرایه‌ها و اشیای درون‌خطی را به خطوط تمیز و تورفته گسترش دهید، یا آن‌ها را دوباره به‌صورت درون‌خطی جمع کنید — برای PHP، JavaScript، TypeScript، JSON، Python، Ruby و موارد دیگر. رایگان
تستر Regex عبارات منظم را مستقیماً در مرورگر خود بسازید، تست و اشکال‌زدایی کنید — برجسته‌سازی فوری مطابقت‌ها، گروه‌های capture، پیش‌نمایش جایگزینی، توضیح به زبان ساده و کد آماده برای چسباندن برای بیش از ۱۵ زبان. رایگان
سازنده عبارت Cron یک عبارت cron از یک فرم بصری و ساده بسازید — هر فیلد را تنظیم کنید، عبارت زنده، برنامه قابل خواندن برای انسان و زمان‌های اجرای بعدی را ببینید، سپس هر عبارتی را به فرم parse کنید. رایگان
رمزگشای JWT هدر و payload یک JWT را رمزگشایی کنید (امضا تأیید نمی‌شود). رایگان
جستجوهای پرطرفدار
جستجوی کد خطا پایگاه داده پیام خطا این خطا یعنی چه کدهای خطای ویندوز کدهای خطای کروم لیست کدهای خطای http رفع پیام خطا معنی کد خطا
به کمک نیاز دارید؟
با این ابزار مشکلی پیدا کردید؟ به تیم ما اطلاع دهید.
گزارش مشکل

این ابزار رایگان را به وب‌سایت خود اضافه کنید — کد زیر را کپی و جای‌گذاری کنید.