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

رفع ENOENT package.json در npm؛ پوشه درست برنامه کجاست؟

پیدا کردن پوشه درست پروژه و فایل package.json هنگام خطای ENOENT در npm و پنل هاست.

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع ENOENT package.json در npm؛ پوشه درست برنامه کجاست؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
در زمان اجرای npm خطایی مانند ENOENT: no such file or directory, open .../package.json می‌بینید. معنی آن این است که npm نتوانسته فایل مورد نیاز را در مسیری که گزارش کرده باز کند. رایج‌ترین علت، ورود به پوشه اشتباه یا انتقال ناقص پروژه است؛ گاهی نیز نام فایل یا تنظیم ریشه برنامه در پنل درست نیست.
ابتدا خود مسیر خطا و ساختار پروژه را می‌خوانیم. ساختن یک package.json خالی با npm init برای پروژه موجود می‌تواند وابستگی‌ها و فرمان‌های واقعی را پنهان کند، پس فایل اصلی را از نسخه تأییدشده برمی‌گردانیم.

۱. مسیر خطا را با پوشه فعلی مقایسه کنید

در Terminal یا SSH حساب:
کد / دستورpwd ls -la npm prefix node --version npm --version
pwd پوشه فعلی و ls فایل‌ها را نشان می‌دهد. npm prefix نزدیک‌ترین ریشه محلی تشخیص‌داده‌شده را گزارش می‌کند و می‌تواند پوشه والد دارای package.json یا node_modules باشد؛ این فرمان از همه جزئیات workspace آگاه نیست. مسیری را که در پیام open آمده دقیق بخوانید و آن را با ساختار واقعی پروژه مقایسه کنید.
اگر پروژه در ~/myproject/app قرار دارد، ابتدا همان مسیر واقعی را انتخاب کنید:
کد / دستورcd ~/myproject/app pwd ls -la package.json
این مسیر فقط مثال است. وجود فایل با نام مشابه اما حروف متفاوت کافی نیست؛ روی بیشتر سرورهای لینوکسی Package.json و package.json یکسان نیستند. نامی مثل package.json.txt نیز فایل موردنظر npm نیست.

۲. اگر مخزن چند برنامه دارد

ممکن است پوشه اصلی مخزن حاوی frontend و backend باشد و هر کدام package.json جداگانه داشته باشند. فایل راهنمای پروژه یا تنظیم استقرار را بخوانید تا بدانید کدام بخش قرار است اجرا شود. در ساختار workspace، گاهی نصب باید از ریشه و اجرای یک اسکریپت از بسته مشخص انجام شود؛ به فایل قفل و راهنمای همان پروژه تکیه کنید.
در پنل هاست Node.js، مقدار Application root یا بخش معادل را با پوشه موردنظر تطبیق دهید. نام و رفتار این قسمت به سرویس بستگی دارد. پیش از تغییر برنامه فعال، مقدار قبلی را یادداشت و یک برنامه آزمایشی مستقل بسازید. تغییر ریشه ممکن است مسیر فایل شروع و متغیرهای محیطی را نیز تحت تأثیر قرار دهد.

۳. اگر فایل واقعاً منتقل نشده است

مخزن یا بسته انتشار تأییدشده همان نسخه برنامه را باز کنید و وجود package.json را در مبدأ ببینید. گاهی هنگام ZIP کردن فقط محتوای پوشه خروجی یا زیرپوشه اشتباه منتقل شده است. فایل و ساختار موردنیاز را در کپی آزمایشی کامل کنید؛ فایل package-lock.json نیز باید با همان نسخه پروژه هماهنگ باشد.
اگر هیچ نسخه معتبر از فایل ندارید، آن را از توسعه‌دهنده یا نسخه پشتیبان سالم بخواهید. یک فایل تازه و خالی نام و نسخه وابستگی‌های واقعی، اسکریپت‌ها و تنظیمات پروژه را بازسازی نمی‌کند. همچنین دانلود package.json پروژه‌ای دیگر می‌تواند وابستگی نامربوط یا ناامن وارد برنامه کند.
یک علت رایج دیگر، پوشه اضافه پس از استخراج ZIP است: مثلاً پنل روی myproject تنظیم شده، اما فایل واقعی داخل myproject/myproject قرار گرفته است. پیش از جابه‌جایی فایل‌های سایت، ساختار بسته انتشار و مسیر ریشه برنامه آزمایشی را کنار هم ببینید. انتقال کل محتویات به پوشه بالاتر بدون بررسی ممکن است فایل‌های تنظیم و مسیرهای وابسته را بشکند.
اگر فایل را می‌بینید ولی پیام Permission denied است، این دیگر خطای «وجود نداشتن» نیست. مجوز خواندن فایل و عبور از پوشه‌های والد را برای حساب اجراکننده بررسی کنید. دادن دسترسی نوشتن همگانی یا اجرای npm با دسترسی مدیر برای رفع یک مسیر اشتباه، راه مناسبی نیست.

۴. فایل را بدون تغییر آزمایش کنید

در پوشه دارای فایل:
کد / دستورnode -e "const p=require('./package.json'); console.log('name:', p.name); console.log('scripts:', p.scripts)" npm run
فرمان اول فایل JSON را می‌خواند و نام و اسکریپت‌ها را نشان می‌دهد؛ اگر خطای نحوی JSON باشد، پیام آن با ENOENT فرق دارد. فرمان دوم اسکریپت‌های npm را فهرست می‌کند. اطلاعات محرمانه را در package.json نگذارید و خروجی خصوصی را پیش از ارسال بررسی کنید.
پس از تأیید فایل و قفل، اگر پروژه از npm و فایل قفل هماهنگ استفاده می‌کند، npm ci را فقط در کپی آزمایشی اجرا کنید. این فرمان node_modules موجود همان پوشه را پاک می‌کند و ممکن است اسکریپت نصب اجرا کند؛ منبع کد و بسته‌ها باید مورد اعتماد باشد.

۵. برنامه را با روش پنل بالا بیاورید

بعد از نصب و build موردنیاز، فایل شروع و ریشه را با تنظیم پنل مقایسه کنید و برنامه آزمایشی را اجرا کنید. اگر پیام بعدی Missing script: start است، راهنمای اسکریپت start مرحله مربوط را توضیح می‌دهد. اگر فایل شروع وجود دارد ولی ماژولی پیدا نمی‌شود، راهنمای Cannot find module مسیر متفاوتی دارد.
برای اطلاعات سرویس هاست Node.js نت‌آرام و برای نحوه انتخاب ریشه بسته مستندات npm را ببینید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

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

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