Trong quá trình quản lý và vận hành ứng dụng Node.js trên cPanel thông qua plugin Setup Node.js App, người dùng đôi khi gặp lỗi “Can’t acquire lock for app” khi thực hiện các thao tác như chỉnh sửa ứng dụng, restart, chạy npm install hoặc xóa app. Lỗi này khiến việc cập nhật và triển khai ứng dụng bị gián đoạn. Bài viết dưới đây sẽ giúp bạn hiểu rõ nguyên nhân và hướng dẫn cách khắc phục lỗi một cách an toàn, nhanh chóng để ứng dụng Node.js hoạt động bình thường trở lại.
Các bước khắc phục lỗi
Bước 1: Truy cập vào File Manager hoặc SSH
Đầu tiên, bạn cần đăng nhập vào giao diện quản trị cPanel. Để xử lý file gây lỗi, bạn có thể chọn một trong hai cách:
- Cách 1 (File Manager): Mở File Manager, bạn vào phần Settings ở góc trên bên phải và tích chọn Show Hidden Files (dotfiles) để hiển thị các file ẩn có dấu chấm ở đầu (file
.lock). - Cách 2 (SSH/Terminal): Nếu gói Hosting của bạn hỗ trợ, hãy kết nối qua SSH hoặc sử dụng tính năng Terminal trực tiếp trên cPanel để thao tác nhanh và chính xác hơn.
Bước 2: Xác định đường dẫn thư mục virtual environment của ứng dụng
Tiếp theo, bạn cần biết chính xác vị trí của file .lock.
- Trong cPanel, điều hướng đến Setup Node.js App.
- Tìm ứng dụng đang bị lỗi trong danh sách.
- Nhìn vào cột Application root, bạn sẽ thấy đường dẫn gốc của ứng dụng.
- Đường dẫn đến thư mục môi trường ảo (virtual environment) thường có cấu trúc như sau:
/home/your_cpanel_username/nodevenv/your_app_folder_name/- Hãy thay
your_cpanel_usernamebằng tên người dùng cPanel của bạn. - Thay
your_app_folder_namebằng tên thư mục của ứng dụng (ví dụ:myapp,16,backend…).
- Hãy thay
Bước 3: Xóa file .lock
- Cách 1 (Sử dụng File Manager): Trong File Manager, bạn tìm đến đường dẫn thư mục đã xác định ở Bước 2. Tiếp theo, bạn tìm file có tên chính xác là
.lock, sau đó nhấp chuột phải vào file .lock và chọn Delete. Cuối cùng, bạn xác nhận việc xóa file.
- Cách 2 (Sử dụng SSH hoặc Terminal): Bạn chạy lệnh sau để di chuyển và xóa file nhanh chóng:
cd /home/username/nodevenv/tên_ứng_dụng/
rm -f .lock
Bước 4: Kiểm tra kết quả
Sau khi xóa file, bạn quay lại mục Setup Node.js App và thử thực hiện các thao tác như Restart hoặc Run NPM Install. Nếu hệ thống phản hồi bình thường và không còn hiện cảnh báo, bạn đã khắc phục thành công.
Mẹo phòng tránh lỗi trong tương lai
Để giảm thiểu khả năng gặp lại lỗi này, bạn hãy tạo thói quen tốt khi quản lý ứng dụng:
- Trước khi chỉnh sửa hoặc chạy
npm install, luôn nhấn Stop Application trong Setup Node.js App. - Không sử dụng “Run NPM Install” để chạy daemon lâu dài.
- Nếu cần chạy background task, cân nhắc dùng PM2 (nếu hosting cho phép) và quản lý qua SSH.
Lỗi “Can’t acquire lock for app” tuy gây gián đoạn nhưng hoàn toàn có thể xử lý nhanh chóng chỉ bằng cách xóa file .lock đúng vị trí. Khi nắm rõ nguyên nhân và quy trình khắc phục, bạn sẽ quản lý và cập nhật ứng dụng Node.js trên cPanel hiệu quả hơn, hạn chế downtime và đảm bảo website hoặc API luôn vận hành ổn định.
VIETNIX – DỊCH VỤ HOSTING, VPS TỐC ĐỘ CAO, ỔN ĐỊNH, BẢO MẬT
- Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh
- Điện thoại: 1800 1093
- Email liên hệ: sales@vietnix.com.vn
- Website: https://vietnix.vn/
