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

رفع خطای Missing script: start در هاست Node.js؛ برنامه را از کجا اجرا کنیم؟

تشخیص علت نبود اسکریپت start در package.json و تنظیم فرمان اجرای مناسب پروژه Node.js روی هاست.

انتشار:
توسط تیم فنی نت‌آرام
۴ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع خطای Missing script: start در هاست Node.js؛ برنامه را از کجا اجرا کنیم؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
در ترمینال یا پنل هاست npm start را اجرا می‌کنید و پیام Missing script: start می‌بینید. این پیام معمولاً یعنی npm برای بسته‌ای که در پوشه فعلی پیدا کرده، دستور شروع مناسبی ندارد. شاید در پوشه اشتباه هستید، اسکریپت هنوز تعریف نشده یا پروژه شما فقط خروجی استاتیک می‌سازد و اصلاً به یک سرویس Node.js دائمی نیاز ندارد.
قبل از افزودن یک خط تصادفی، نوع پروژه و فایل شروع واقعی را پیدا می‌کنیم. نمونه‌ها را در کپی آزمایشی پروژه اجرا کنید تا سایت فعال با یک فرمان اشتباه از کار نیفتد.

۱. پوشه فعلی و اسکریپت‌های همان بسته را ببینید

در Terminal یا SSH حساب هاست:
کد / دستورpwd ls -la ls -la package.json npm run
pwd مسیر فعلی، ls فایل‌ها و npm run اسکریپت‌های تعریف‌شده برای بسته فعلی را نشان می‌دهد. اگر package.json در این پوشه نیست، اول ریشه برنامه را از تنظیم پنل و ساختار مخزن پیدا کنید. در پروژه چندبخشی ممکن است پوشه اصلی مخزن و پوشه برنامه وب دو بسته جدا باشند؛ وارد همان پوشه‌ای شوید که فایل و اسکریپت برنامه موردنظر را دارد.
فایل را فقط بخوانید:
کد / دستورcat package.json node --version npm --version
بخش scripts، نسخه‌های پشتیبانی‌شده و مستندات پروژه را ببینید. اگر پنل نسخه Node خاصی انتخاب می‌کند، فعال‌سازی محیط آن ممکن است لازم باشد؛ نسخه ترمینال و نسخه اجرای سایت را با هم تطبیق دهید.

۲. بدانید npm دقیقاً دنبال چه چیزی می‌گردد

اگر در scripts اسکریپتی به نام start باشد، npm start همان دستور را اجرا می‌کند. npm در شرایطی که فایل server.js در ریشه بسته وجود دارد، می‌تواند دستور پیش‌فرض node server.js را به کار ببرد؛ این با فیلد main یکسان نیست. اگر فایل و اسکریپت هیچ‌کدام مناسب نباشند، پیام نبود start دیده می‌شود.
وجود فایلی به نام server.js نیز به‌تنهایی ثابت نمی‌کند آن فایل نقطه شروع پروژه شماست. مستندات و ساختار پروژه را بخوانید و بررسی کنید سرویس هاست به فرمان npm نیاز دارد یا فایل شروع را جداگانه از طریق Passenger یا پنل می‌گیرد.

۳. برای یک برنامه ساده، فایل شروع واقعی را مشخص کنید

فرض کنید توسعه‌دهنده تأیید کرده فایل برنامه app.js در ریشه همان بسته قرار دارد. در package.json موجود، بخش scripts می‌تواند چنین موردی داشته باشد:
کد / دستور{ "scripts": { "start": "node app.js" } }
این قطعه فقط شکل تنظیم را نشان می‌دهد؛ کل package.json پروژه را با آن جایگزین نکنید. اسکریپت‌های قبلی و سایر فیلدها را نگه دارید و ویرگول و ساختار JSON را درست بگذارید. اگر بخش scripts از قبل وجود دارد، همان‌جا مورد جدید را اضافه کنید، نه اینکه یک کلید تکراری بسازید. پیش از ویرایش نسخه پشتیبان بگیرید.
در کپی آزمایشی:
کد / دستورnode -e "const p=require('./package.json'); console.log(p.scripts)" ls -la app.js npm start
فرمان اول صحت خواندن فایل و فهرست اسکریپت‌ها را نشان می‌دهد، دومی وجود فایل مثال را بررسی می‌کند و سومی برنامه را واقعاً شروع می‌کند. شروع برنامه ممکن است پورت باز کند، به پایگاه داده وصل شود یا کار پس‌زمینه انجام دهد؛ فقط در محیط آزمایشی و با تنظیمات امن آن را اجرا کنید. برای پایان اجرای پیش‌زمینه معمولاً Ctrl+C استفاده می‌شود.

۴. اگر خروجی ساخته‌شده یا فریم‌ورک دارید

در پروژه TypeScript ممکن است فایل اصلی پس از build در dist تولید شود. اول دستور ساخت تأییدشده پروژه را اجرا و مسیر واقعی خروجی را پیدا کنید؛ سپس فرمان شروع را مطابق آن بنویسید. راهنمای نبود dist این مسیر را توضیح می‌دهد.
برخی پروژه‌ها فقط فایل HTML و CSS تولید می‌کنند و خروجی آن‌ها با وب‌سرور استاتیک تحویل می‌شود؛ اضافه‌کردن node app.js برایشان معنی ندارد. بعضی فریم‌ورک‌ها نیز فرمان خاص خود را دارند و باید حالت build و production مطابق راهنمای همان نسخه انتخاب شود. دستور dev معمولاً برای توسعه است و نباید بدون بررسی جایگزین اجرای تولید شود.
در هاستی که پنل فایل شروع Passenger را می‌خواهد، تنظیم آن با npm start یکسان نیست. درباره مسیر فایل و شیوه گوش‌دادن به پورت از راهنمای همان سرویس استفاده کنید؛ یک پورت ثابت را از پروژه دیگر کپی نکنید.

۵. نتیجه را در محیط سرویس بسنجید

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

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

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